mirror of
https://github.com/sourcegraph/sourcegraph.git
synced 2026-02-06 19:21:50 +00:00
This PR is on top of #54517 --- This PR rework how we handle the docsite and some of its related tasks: - While we _could_ avoid committing the generated files to disk, the way that docsite currently works, requires to have all files available in git, so the docsite can serve various versions. - `bazel run //doc/cli/references:write_doc_files` handles this (and it's umbreall `//dev:write_all_generated`. - Its generation is now handled by `//doc/cli/references:generate_doc` and its associated test. - `sg run docsite` now calls `bazel run //doc:serve`, we don't need to install the docsite directly anymore (but it's available under `bazel run //dev/tools:docsite` if needed). As a byproduct, we can now run `src-cli` with `bazel run //dev/tools:src-cli` which will pick the correct binary for your machine transparently. ## Test plan <!-- All pull requests REQUIRE a test plan: https://docs.sourcegraph.com/dev/background-information/testing_principles --> Locally tested + CI |
||
|---|---|---|
| .. | ||
| _resources | ||
| admin | ||
| api | ||
| app | ||
| batch_changes | ||
| cli | ||
| cloud | ||
| code_insights | ||
| code_monitoring | ||
| code_navigation | ||
| code_search | ||
| cody | ||
| dev | ||
| dotcom | ||
| getting-started | ||
| integration | ||
| notebooks | ||
| own | ||
| tutorials | ||
| BUILD.bazel | ||
| CHANGELOG.md | ||
| CODENOTIFY | ||
| dependency_decisions.yml | ||
| docsite.json | ||
| index.md | ||
| serve.sh | ||
| sidebar.md | ||
| test.sh | ||