Uses Gatsby for rendering a static site that is built and deployed with Netlify.
What | Command |
---|---|
Auto-preview about.sourcegraph.com | cd website && yarn install && yarn start |
Final review about.sourcegraph.com | cd website && yarn install && yarn serve |
Preview handbook | make serve |
Check for broken links | make docsite-check |
Gatsby requires Node.js, and we recommend using yarn for installing packages.
Developing the static site locally is separate from developing the handbook. Read the Handbook section to learn how to develop the handbook locally.
In a terminal, change into the website
directory, and run:
yarn install
Then to serve the site, you have two options:
- To serve the static (built) version of the website (good for final review):
yarn serve
- To serve the site using the development server with auto-compiling and page reloading:
yarn start
We want and encourage everyone at Sourcegraph to contribute to the blog and publishing a blog post is as simple as merging an approved pull request with your blog content.
Learn how to create and publish a blog post.
The Sourcegraph handbook also lives in this repository. This is currently deployed in GCP.
The handbook uses docsite.
- To preview changes to handbook content locally, run
make serve
from the root of the about repository (/about
), and open http://localhost:5082. - To check for broken links and other lint problems, run
make docsite-check
. - See detailed
docsite
instructions.