Documentation pages on the Pharos site are written using MDX — markdown files that allow you to integrate JSX easily. This combines the ease in editing long-form content with being able to import components which can elevate the content. These file names should be kebab-cased and named to match the component and what will be displayed in the side navigation bar.
Components used in the documentation can be found in
/src/components. Examples of them being used and imported can be seen in other existing MDX files found in
pharos-site/src/static. Please use the
<PageSection> component for each documentation category and use its
subSectionLevel property for subsections under the category. For best practices, also use the
Adding page to side-navigation bar
When creating a new section or page of documentation, it is important to add a link to the page in the sidenav so that users can readily navigate to the page. This involves accessing the sidenav component in
pharos-site/src/components/Sidenav.tsx and adding the newly made page to the appropriate array, which will generate a link in the sidenav automatically. Consequently, it is important to follow the naming conventions mentioned in the MDX section.
Making a pull request
Once a page has been created or documentation has been modified, you can then generate a pull request indicating the changes made.