2020-10-08 05:13:59 +00:00
|
|
|
# Developing Sourcegraph
|
2018-10-17 20:34:24 +00:00
|
|
|
|
2021-11-29 12:45:47 +00:00
|
|
|
<style>
|
|
|
|
|
.markdown-body h2 {
|
|
|
|
|
margin-top: 2em;
|
|
|
|
|
}
|
|
|
|
|
.markdown-body ul {
|
|
|
|
|
list-style:none;
|
|
|
|
|
padding-left: 1em;
|
|
|
|
|
}
|
|
|
|
|
.markdown-body ul li {
|
|
|
|
|
margin: 0.5em 0;
|
|
|
|
|
}
|
|
|
|
|
.markdown-body ul li:before {
|
|
|
|
|
content: '';
|
|
|
|
|
display: inline-block;
|
|
|
|
|
height: 1.2em;
|
|
|
|
|
width: 1em;
|
|
|
|
|
background-size: contain;
|
|
|
|
|
background-repeat: no-repeat;
|
|
|
|
|
background-image: url(../batch_changes/file-icon.svg);
|
|
|
|
|
margin-right: 0.5em;
|
|
|
|
|
margin-bottom: -0.29em;
|
|
|
|
|
}
|
|
|
|
|
body.theme-dark .markdown-body ul li:before {
|
|
|
|
|
filter: invert(50%);
|
|
|
|
|
}
|
|
|
|
|
</style>
|
|
|
|
|
|
|
|
|
|
<p class="subtitle">Documentation for <b>developers contributing to the Sourcegraph code base</b></p>
|
|
|
|
|
|
|
|
|
|
<div class="cta-group">
|
|
|
|
|
<a class="btn btn-primary" href="setup/quickstart">★ Quickstart: develop Sourcegraph on your machine</a>
|
|
|
|
|
<a class="btn" href="https://github.com/sourcegraph/sourcegraph">GitHub repository</a>
|
|
|
|
|
<a class="btn" href="https://github.com/sourcegraph/sourcegraph/issues">Issue Tracker</a>
|
|
|
|
|
</div>
|
|
|
|
|
|
2023-07-26 15:57:29 +00:00
|
|
|
## Setup
|
2021-11-29 12:45:47 +00:00
|
|
|
|
|
|
|
|
<p class="subtitle">Learn how to develop Sourcegraph on your machine.</p>
|
|
|
|
|
|
|
|
|
|
<div class="getting-started">
|
|
|
|
|
<a href="setup/quickstart" class="btn" alt="Run through the Quickstart guide">
|
|
|
|
|
<span>★ Quickstart</span>
|
2023-08-07 15:54:41 +00:00
|
|
|
<br>
|
2021-11-29 12:45:47 +00:00
|
|
|
Run through the <b>step by step guide</b> and get your local environment ready.
|
|
|
|
|
</a>
|
|
|
|
|
|
2022-01-18 08:27:07 +00:00
|
|
|
<a href="../dev/how-to" class="btn" alt="How-to guides">
|
2021-11-29 12:45:47 +00:00
|
|
|
<span>How-to guides</span>
|
2023-08-07 15:54:41 +00:00
|
|
|
<br>
|
2022-01-18 08:27:07 +00:00
|
|
|
<b>Context specific</b> guides: debugging live code
|
2021-11-29 12:45:47 +00:00
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
<a href="setup/troubleshooting" class="btn" alt="Troubleshooting">
|
|
|
|
|
<span>Troubleshooting</span>
|
2023-08-07 15:54:41 +00:00
|
|
|
<br>
|
2021-11-29 12:45:47 +00:00
|
|
|
Help for the <b>most common</b> problems.
|
|
|
|
|
</a>
|
|
|
|
|
</div>
|
2021-03-15 12:05:24 +00:00
|
|
|
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
## Background information
|
2020-10-08 05:13:59 +00:00
|
|
|
|
2020-12-02 14:08:38 +00:00
|
|
|
Clarification and discussion about key concepts, architecture, and development stack.
|
2020-10-08 05:13:59 +00:00
|
|
|
|
2023-07-26 15:57:29 +00:00
|
|
|
### Architecture
|
2021-03-15 12:05:24 +00:00
|
|
|
|
|
|
|
|
- [Overview](background-information/architecture/index.md)
|
|
|
|
|
- [Introducing a new service](background-information/architecture/introducing_a_new_service.md)
|
|
|
|
|
|
|
|
|
|
### Development
|
|
|
|
|
|
2021-10-12 12:49:10 +00:00
|
|
|
- [`sg` - the Sourcegraph developer tool](background-information/sg/index.md)
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Using Bazel](background-information/bazel/index.md)
|
|
|
|
|
- [Bazel and Go code](background-information/bazel/go.md)
|
|
|
|
|
- [Bazel and client code](background-information/bazel/web.md)
|
|
|
|
|
- [Bazel and container images](background-information/bazel/containers.md)
|
|
|
|
|
- [Bazel FAQ](background-information/bazel/faq.md)
|
|
|
|
|
- [Writing a server integration test](background-information/bazel/server_integration_tests.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Developing the web clients](background-information/web/index.md)
|
|
|
|
|
- [Developing the web app](background-information/web/web_app.md)
|
|
|
|
|
- [Developing the code host integrations](background-information/web/code_host_integrations.md)
|
2021-03-31 09:30:36 +00:00
|
|
|
- [Working with GraphQL](background-information/web/graphql.md)
|
|
|
|
|
- [Wildcard Component Library](background-information/web/wildcard.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Styling UI](background-information/web/styling.md)
|
2021-03-31 09:30:36 +00:00
|
|
|
- [Accessibility](background-information/web/accessibility.md)
|
2021-09-01 18:53:07 +00:00
|
|
|
- [Temporary settings](background-information/web/temporary_settings.md)
|
2021-03-31 09:30:36 +00:00
|
|
|
- [Build process](background-information/web/build.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Developing the GraphQL API](background-information/graphql_api.md)
|
2023-03-21 12:48:01 +00:00
|
|
|
- [Developing the SCIM API](background-information/scim_api.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Developing batch changes](background-information/batch_changes/index.md)
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Developing code intelligence](background-information/codeintel/index.md)
|
2021-08-30 20:29:00 +00:00
|
|
|
- [Developing code insights](background-information/insights/index.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Developing code monitoring](background-information/codemonitoring/index.md)
|
|
|
|
|
- [Developing observability](background-information/observability/index.md)
|
|
|
|
|
- [Dependencies and generated code](background-information/dependencies_and_codegen.md)
|
2021-12-17 19:58:16 +00:00
|
|
|
- [Code reviews](background-information/pull_request_reviews.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Commit messages](background-information/commit_messages.md)
|
|
|
|
|
- [Exposing services](background-information/exposing-services.md)
|
|
|
|
|
- [Developing a store](background-information/basestore.md)
|
|
|
|
|
- [Developing a worker](background-information/workers.md)
|
|
|
|
|
- [Developing an out-of-band migration](background-information/oobmigrations.md)
|
|
|
|
|
- [Developing a background routine](background-information/backgroundroutine.md)
|
2022-02-08 22:29:25 +00:00
|
|
|
- [Testing](#testing)
|
|
|
|
|
- [Testing principles and guidelines](background-information/testing_principles.md)
|
2022-02-28 16:16:20 +00:00
|
|
|
- [Continuous integration](background-information/ci/index.md)
|
2022-02-08 22:29:25 +00:00
|
|
|
- [How to write and run tests](how-to/testing.md)
|
|
|
|
|
- [Testing Go code](background-information/languages/testing_go_code.md)
|
|
|
|
|
- [Testing web code](background-information/testing_web_code.md)
|
2023-01-12 14:43:25 +00:00
|
|
|
- [Building p4-fusion](background-information/build_p4_fusion.md)
|
2023-02-02 00:29:56 +00:00
|
|
|
- [The `gitserver` API](background-information/gitserver-api.md)
|
2024-04-16 14:51:00 +00:00
|
|
|
- [gRPC Tutorial](background-information/grpc_tutorial.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
### Git
|
2023-02-17 12:32:09 +00:00
|
|
|
|
2023-05-12 21:57:43 +00:00
|
|
|
- [`git gc` and its modes of operations in Sourcegraph](background-information/git_gc.md)
|
2023-02-17 12:32:09 +00:00
|
|
|
|
2023-07-26 15:57:29 +00:00
|
|
|
### Languages
|
2021-03-15 12:05:24 +00:00
|
|
|
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Tech stack](background-information/tech_stack.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Go](background-information/languages/go.md)
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Error handling in Go](background-information/languages/go_errors.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [TypeScript](background-information/languages/typescript.md)
|
|
|
|
|
- [Bash](background-information/languages/bash.md)
|
|
|
|
|
- [Terraform](background-information/languages/terraform.md)
|
|
|
|
|
|
2023-07-26 15:57:29 +00:00
|
|
|
### SQL
|
2022-01-10 14:26:46 +00:00
|
|
|
|
2022-02-08 22:29:25 +00:00
|
|
|
- [Using PostgreSQL](background-information/postgresql.md)
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Migrations overview](background-information/sql/migrations_overview.md)
|
2022-01-10 14:26:46 +00:00
|
|
|
- [Migrations](background-information/sql/migrations.md)
|
|
|
|
|
- High-performance guides
|
|
|
|
|
- [Batch operations](background-information/sql/batch_operations.md)
|
|
|
|
|
- [Materialized cache](background-information/sql/materialized_cache.md)
|
|
|
|
|
|
2021-11-01 17:54:40 +00:00
|
|
|
### Security
|
|
|
|
|
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Security patterns](background-information/security_patterns.md)
|
2023-12-01 22:22:34 +00:00
|
|
|
- [Security policy](https://sourcegraph.com/security/)
|
|
|
|
|
- [How to disclose vulnerabilities](https://sourcegraph.com/handbook/engineering/security/reporting-vulnerabilities).
|
2021-11-01 17:54:40 +00:00
|
|
|
- [CSRF security model](security/csrf_security_model.md)
|
2023-10-20 12:05:28 +00:00
|
|
|
- [Sourcegraph secret formats](security/secret_formats.md)
|
2021-11-01 17:54:40 +00:00
|
|
|
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
### Testing
|
|
|
|
|
|
|
|
|
|
- [Continuous integration](background-information/ci/index.md)
|
|
|
|
|
- [Testing a pull request](background-information/testing_pr.md)
|
|
|
|
|
- [Testing principles](background-information/testing_principles.md)
|
|
|
|
|
- [Testing Go code](background-information/languages/testing_go_code.md)
|
|
|
|
|
- [Testing web code](background-information/testing_web_code.md)
|
2023-08-08 10:12:31 +00:00
|
|
|
- [Code host test plans](background-information/test-plans/code-hosts/index.md)
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
|
2021-03-15 12:05:24 +00:00
|
|
|
### Tools
|
|
|
|
|
|
|
|
|
|
- [Renovate dependency updates](background-information/renovate.md)
|
|
|
|
|
- [Honeycomb](background-information/honeycomb.md)
|
2022-03-23 12:21:59 +00:00
|
|
|
- [GoLand](background-information/goland.md)
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Wolfi overview](background-information/wolfi/index.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
|
|
|
|
|
### Other
|
|
|
|
|
|
2023-09-22 17:58:08 +00:00
|
|
|
- [Telemetry](background-information/telemetry/index.md)
|
2021-03-15 12:05:24 +00:00
|
|
|
- [Adding, changing and debugging pings](background-information/adding_ping_data.md)
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Deploy Sourcegraph with Helm chart (BETA)](../../../admin/deploy/kubernetes/helm.md)
|
|
|
|
|
- [GitHub API oddities](background-information/github-api-oddities.md)
|
2021-10-08 12:20:50 +00:00
|
|
|
|
2023-07-26 15:57:29 +00:00
|
|
|
## How-to guides
|
2021-10-08 12:20:50 +00:00
|
|
|
|
|
|
|
|
Guides to help with troubleshooting, configuring test instances, debugging, and more.
|
|
|
|
|
|
|
|
|
|
### New features
|
|
|
|
|
|
|
|
|
|
- [How to add support for a language](how-to/add_support_for_a_language.md)
|
|
|
|
|
- [How to use feature flags](how-to/use_feature_flags.md)
|
2022-10-18 12:06:05 +00:00
|
|
|
- [How to add caching](how-to/add_caching.md)
|
2021-10-08 12:20:50 +00:00
|
|
|
|
2022-02-08 22:29:25 +00:00
|
|
|
### Observability
|
2021-10-08 12:20:50 +00:00
|
|
|
|
2022-05-04 15:07:14 +00:00
|
|
|
- [How to add observability](how-to/add_observability.md)
|
|
|
|
|
- [How to add logging](how-to/add_logging.md)
|
2022-02-08 22:29:25 +00:00
|
|
|
- [How to find monitoring](how-to/find_monitoring.md)
|
|
|
|
|
- [How to add monitoring](how-to/add_monitoring.md)
|
2022-07-05 18:28:15 +00:00
|
|
|
- [Set up local monitoring development](how-to/monitoring_local_dev.md)
|
2022-09-07 12:45:22 +00:00
|
|
|
- [Set up local OpenTelemetry development](how-to/opentelemetry_local_dev.md)
|
2021-10-08 12:20:50 +00:00
|
|
|
|
2022-09-07 15:39:08 +00:00
|
|
|
### Plans and licenses
|
|
|
|
|
|
|
|
|
|
- [How to generate a license key for testing and debugging](how-to/generate_license_key_for_testing.md)
|
|
|
|
|
|
2022-02-08 22:29:25 +00:00
|
|
|
### Documentation
|
2021-10-08 12:20:50 +00:00
|
|
|
|
2022-02-08 22:29:25 +00:00
|
|
|
- [Developing the product documentation](how-to/documentation_implementation.md)
|
2021-10-08 12:20:50 +00:00
|
|
|
|
2022-02-01 14:42:44 +00:00
|
|
|
### Executors
|
|
|
|
|
|
|
|
|
|
- [How to deploy a new executor image](how-to/deploy_executor_image.md)
|
|
|
|
|
|
2022-02-08 22:29:25 +00:00
|
|
|
### Testing
|
|
|
|
|
|
|
|
|
|
- [How to write and run tests](how-to/testing.md)
|
2022-12-08 10:30:38 +00:00
|
|
|
- [Run a local Sourcegraph instance behind ngrok](how-to/sourcegraph_ngrok.md)
|
2022-02-08 22:29:25 +00:00
|
|
|
- Testing against code hosts
|
|
|
|
|
- [Configure a test instance of Phabricator and Gitolite](how-to/configure_phabricator_gitolite.md)
|
|
|
|
|
- [Test a Phabricator and Gitolite instance](how-to/test_phabricator.md)
|
2022-08-03 07:39:08 +00:00
|
|
|
- [Sync repositories from gitolite.sgdev.org](how-to/sync_repositories_from_gitolite_sgdev_org.md)
|
2022-02-08 22:29:25 +00:00
|
|
|
|
2023-07-26 15:57:29 +00:00
|
|
|
## Contributing
|
2021-10-22 15:55:44 +00:00
|
|
|
|
docs: clean up development docs table of contents (#55175)
While looking up developer docs about a couple things, I felt compelled
to do a bit of cleanup.
We had two docs, `dev/index.md` and
`dev/background-information/index.md`, which featured the same lengthy
table of contents to other subpages. The two lists were meant to be
identical, as was noted by a comment at the top of the latter doc:
```
<!-- Link back any new sections to doc/dev/index.md as well -->
```
But the lists had actually diverged quite a bit, and frankly it just
felt redundant to have the latter doc when it was literally only this
table of contents and nothing else. So I removed the redundant doc,
merged the lists, dropped outdated and duplicative subpage links, and
regrouped a couple sections that only had one or two items listed under
then. The header hierarchy had also gotten messed up in a couple ways
(for example SQL was listed as a subsection of `git` 🤪), so I fixed that
up. This hopefully means both maintaining and browsing the developer
docs will be easier!
I have left a couple comments inline to clarify items that were moved or
removed.
## Test plan
Tested locally, tried to verify most links still worked!
Also verified the ToC hierarchy is corrected:
<img width="366" alt="image"
src="https://github.com/sourcegraph/sourcegraph/assets/8942601/df064955-6c8f-4a40-bfd2-bf493fc0ec40">
<!-- All pull requests REQUIRE a test plan:
https://docs.sourcegraph.com/dev/background-information/testing_principles
-->
2023-07-21 03:36:50 +00:00
|
|
|
- [Open source FAQ](https://handbook.sourcegraph.com/company-info-and-process/community/faq/)
|
|
|
|
|
- [Code of conduct](https://handbook.sourcegraph.com/company-info-and-process/community/code_of_conduct/)
|
|
|
|
|
- [Project setup and CI checks for frontend issues](./contributing/frontend_contribution.md)
|
|
|
|
|
- [Accepting an external contribution guide](./contributing/accepting_contribution.md)
|