Contributions towards enhancing our documentation are highly valued in the Detox community. Clear, concise, and comprehensive documentation enables users to understand and utilize the project more effectively.
We appreciate all contributions, from correcting typos to creating new documentation pages.
Our documentation website is developed using Docusaurus. To set up a local version of the website for editing, follow these steps:
cd website
npm install
npm startTo modify an existing page, find the associated markdown file in the docs/ directory and make the required changes. To introduce a new page, create a markdown file in docs/ and link to it in website/sidebars.json.
Automatic updates to the website occur with each commit to the master branch, with these changes reflected under the Next version. The process of tagging and locking documentation to a specific version is automated and coincides with each Detox release.
If there's a need to update the documentation of a particular version, modify the associated files and code located under website/versioned_docs/version-<version>/ and website/versioned_sidebars/version-<version>-sidebars.json.
To update an older version with the latest changes:
- Remove the desired version from
versions.json. - Execute
npm run docusaurus docs:version <version>.
If you're making changes to the stylesheets, use this demo page to visually inspect the impact of your changes and avoid unintentional visual regressions.