Contribution Guidelines
If you want to contribute to Clave Documentation by fixing typos or translating the Docs to your native language, you can follow this guide.
Clave uses Mintlify to create documentation. To contribute to Clave, you should start by installing Mintlify first.
Follow these steps to install and run Mintlify on your operating system:
Install Mintlify
npm i -g mintlify
Modifying an Existing Translation
If you want to modify (fixing typos, enhancing the wording etc.) an existing translation
- Fork the Project Make a fork of the clave-docs project and create your branches from the default main branch. If your PR is still a work in progress, consider putting it into a Draft status. Once your PR is ready for review, switch it back to an active PR request, and any reviewers already attached will automatically get a notification.
- And start modifyingg the texts in the MDX files. Please follow PR Rules to Open a PR.
Adding a New Language
-
Fork the Project Make a fork of the clave-docs project and create your branches from the default main branch. If your PR is still a work in progress, consider putting it into a Draft status. Once your PR is ready for review, switch it back to an active PR request, and any reviewers already attached will automatically get a notification.
-
Create a File Named with Your Language (You can use the short form of the language name, for example, we used TR for Turkish)
- Add Your Language to the JSON File
Simply copy the code below and change
yourlanguage
to your language.
To configure all repetitions of a word (e.g.,
yourlanguage
) on the same page in VSCode, follow these steps: Select theyourlanguage
Word: Then, use the key combinationCtrl + Shift + L
(Windows/Linux) orCmd + Shift + L
(Mac) to select all occurrences ofyourlanguage
on the page. This allows you to edit them all at once. This way, you can edit all selected words simultaneously.
Copy the code below and change it to your language
- Add Your Language to Versions In the JSON file, you’ll see the code below that defines the different versions of Clave Docs:
Add the short name of your language to the versions
array to enable indexing for your translations.
- Open Your Language’s File and Start Translating. If your PR is still a work in progress, consider putting it into a Draft status. Once your PR is ready for review, switch it back to an active PR request, and any reviewers already attached will automatically get a notification.