Skip to content

Commit

Permalink
chore: add maintenace notes
Browse files Browse the repository at this point in the history
  • Loading branch information
nhtyy committed Dec 4, 2024
1 parent c372bee commit 515bd57
Showing 1 changed file with 8 additions and 15 deletions.
23 changes: 8 additions & 15 deletions book/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,18 +24,11 @@ $ yarn build

This command generates static content into the `build` directory and can be served using any static contents hosting service.

### Deployment

Using SSH:

```
$ USE_SSH=true yarn deploy
```

Not using SSH:

```
$ GIT_USER=<Your GitHub username> yarn deploy
```

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
### Maintenance Notes

- Always run `npm build` locally first to ensure that the website builds correctly.
- When adding new pages, ensure that the sidebar is updated in `sidebars.ts`.
- Check you links, if youre pointing at an .mdx file, you need to omit the extension in the link.
- Code snippets from the repo are made through the [gen script](./gen-code-refs.sh).
- When adding new code snippets, ensure that the gen script is updated to include the new file.
- Check out the [Docusaurus documentation](https://docusaurus.io/docs/versioning) versioning information.

0 comments on commit 515bd57

Please sign in to comment.