Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
38 lines (21 loc) · 1.86 KB

CONTRIBUTING.md

File metadata and controls

38 lines (21 loc) · 1.86 KB

Contributing

We welcome contributions to the docs. Please file an issue, or open a PR if you find something that needs to be fixed or improved.

For Speechmatics employees

Open a pull request to the main branch. The CI pipeline will build and deploy the docs to Vercel.

For external contributors

Fork this repository, and open a PR against the main branch. Note that this will not create a preview link.

Style guide

Please refer to the style guide for information on writing standards, style and tone of voice. If you're using Windsurf, these rules should be taken into account automatically.

Project structure

This site is built using Docusaurus, a modern static website generator.

URLs and redirects

When changing the URL of a page, you need to take some steps to avoid broken links

  1. Update the /scripts/redirects.json file with the source and target URLs
  2. Run npm run sync-redirects to update vercel.json.
  3. Commit the changes to vercel.json and scripts/redirects/redirects.json.
  4. Update any pages which link to the old URL (CI pipeline should fail with an exhaustive list if any are found)

Content

The pages for the site are located in the /docs directory. Sidebars are configured using the sidebar.ts files located in the respective sections.

Custom UI

Custom UI components are found under the src/theme directory. This includes components which are "Swizzled" from the defaults.

Custom CSS is organised in the src/css folder. Files in this directory are imported into the root src/css/custom.css file for global style overrides. This allows us to integrate Radix Themes as a design system while still using Docusaurus's default layout.