Replatform docs.sourcegraph.com

Created by: marybelzer

Problem to solve

Current tech stack is difficult to develop on and would benefit from more modern caching and search. This initiative should increase velocity on development for the docs site, and enable the technical writing team to create and publish great (and discoverable) content easily.

Measure of success

Docs site is fast, and product and the technical writing team can easily contribute.

Solution summary

• Replatform docs.sourcegraph.com to next.js

Artifacts:

• Docsite is down incident postmortem

What specific customers are we iterating on the problem and solution with?

• Technical Writing Team
• Product Team

Impact on use cases

Docs are critical for our customers to be able to use Sourcegraph to its fullest capacity, and replatforming will better enable the Sourcegraph team to build a best-in-class documentation site. Having a well-functioning docs site can help with:

1. Developer onboarding
2. Code reuse
3. Code health
4. Fixing security vulneratbilities
5. Incident response

Delivery plan

• Scope project
• Schedule work & determine release plan