Welcome to the Symbl Documentation repository!
Our documentation site is built using Docusaurus 2, a static site generator.
- To submit Pull Requests (PRs), always use the
developas the base branch. - We merge changes to master on a weekly basis.
- Go through our Code of Conduct for general best practices to foster community.
- We follow the writing guidelines of Microsoft Styleguide and Google Developer Documentation Style guide so ensure you refer to the same for any editorial guidance for writing and syntax.
To contribute to our documentation,
- Add in your suggestions (by clicking on "Edit this page" button on our docs),
- Enter the required details about the PR. This will give us additional context and a sense of what is required of our team.
- Submit a Pull Request (PR).
The PRs are reviewed every Thursday by our team.
If you wish to suggest a new topic, want to request additional details, or raise any other issues, you can Open an Issue. The resolution time for issues reported is the same as for PRs.
- Clone the Symbl Docs Repo
- Using SSH:
$ git clone git@github.com:symblai/symbl-docs.gitOR
- Using HTTPS:
$ git clone https://github.com/symblai/symbl-docs.git- Open your local directory where you cloned the docs
$ cd symbl-docs- Switch to develop branch to make changes
$ git checkout develop$ yarn$ yarn startThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
$ yarn buildThis command generates static content into the build directory and can be served using any static content hosting service.
$ GIT_USER=<Your GitHub username> USE_SSH=true yarn deployIf you are using GitHub Pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.