sourcegraph/doc
Jean-Hadrien Chabran 588463afbb
bzl: bazelify docsite and doc/cli/reference generation (#54538)
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
2023-07-03 16:12:44 +02:00
..
_resources Docs AI: Combine LLM prompt with instant search (#54088) 2023-06-30 13:12:11 -07:00
admin executors/multi-queue: implement queue selection fairness (#53013) 2023-07-03 12:28:36 +02:00
api Add search pagination limitations and recommendation (#53479) 2023-06-14 15:32:37 +01:00
app App - add note about entitle bundle for updating app manifest (#54334) 2023-06-27 22:40:53 +00:00
batch_changes batches: add 5.1 feature docs (#53898) 2023-06-27 07:36:45 +01:00
cli bzl: bazelify docsite and doc/cli/reference generation (#54538) 2023-07-03 16:12:44 +02:00
cloud Add docs for Cloud audit logs (#54390) 2023-06-29 10:04:22 +02:00
code_insights Fix typos in documentation (#52407) 2023-06-21 07:52:54 -07:00
code_monitoring Fix typos in documentation (#52407) 2023-06-21 07:52:54 -07:00
code_navigation docs: Fix broken links (#54216) 2023-06-26 21:03:06 +00:00
code_search own: rename "Sourcegraph Own" to "Code ownership" (#54483) 2023-07-03 13:05:16 +04:00
cody Add Cody clients page to docs (#54112) 2023-06-28 16:45:34 +00:00
dev release: sourcegraph@5.1.0 (#54325) 2023-06-28 07:38:25 +00:00
dotcom Note differences in sourcegraph.com (#46018) 2022-12-31 07:20:02 +00:00
getting-started Fix typos in documentation (#52407) 2023-06-21 07:52:54 -07:00
integration JetBrains: 3.0.0 release (#54328) 2023-06-27 21:47:32 +00:00
notebooks update notebook embedding with browser restrictions and workaround (#52200) 2023-05-19 15:57:17 +00:00
own own: remove forgotten "Own" references in favor of "Code ownership". (#54536) 2023-07-03 17:48:42 +04:00
tutorials Fix typos in documentation (#52407) 2023-06-21 07:52:54 -07:00
BUILD.bazel bzl: bazelify docsite and doc/cli/reference generation (#54538) 2023-07-03 16:12:44 +02:00
CHANGELOG.md doc: symlink CHANGELOG.md to docs for better search results (#22918) 2021-07-16 23:25:02 +08:00
CODENOTIFY Update docs to upgrade pure_docker from 3.33 to 3.34.2 directly (#28736) 2021-12-08 20:56:46 +00:00
dependency_decisions.yml app: initial work to get building on Windows (#52384) 2023-06-19 14:53:07 -07:00
docsite.json insights: re-index docs (#32415) 2022-03-10 10:05:59 -07:00
index.md Add Cody across docsite (#51494) 2023-05-05 17:31:59 -05:00
serve.sh bzl: bazelify docsite and doc/cli/reference generation (#54538) 2023-07-03 16:12:44 +02:00
sidebar.md own: remove forgotten "Own" references in favor of "Code ownership". (#54536) 2023-07-03 17:48:42 +04:00
test.sh bzl: wrap docsite check into //doc:test (#54376) 2023-06-28 21:00:54 +02:00