Thank you for contributing to the project documentation! This guide will walk you through the process of setting up the project, making changes, and contributing your translations.
To get started, clone the repository to your local machine using the following command:
git clone https://github.com/Raspirus/docs.git
Navigate to the project directory and install the required Python dependencies from the requirements.txt
file using the following command:
pip install -r requirements.txt
You can now start the project locally by running the following command:
mkdocs serve
This will launch a development server, and you can access the documentation by opening https://localhost:8000 in your web browser.
Feel free to make changes to the documentation according to your needs. The changes you make will be reflected in the locally served version of the documentation.
Once you've made your changes and are satisfied with them, it's time to contribute back to the project. Follow these steps to create a pull request:
-
Commit your changes:
git add . git commit -m "Your descriptive commit message here"
-
Push your changes to your forked repository:
git push origin main
-
Open a pull request:
- Visit your forked repository on GitHub.
- Click on the "Pull Requests" tab.
- Click the "New Pull Request" button.
- Select the main branch of the main repository as the base branch.
- Select your forked repository's main branch as the compare branch.
- Add a descriptive title and details about your changes.
- Click "Create Pull Request".
We use Crowdin for translations to make our documentation accessible to a wider audience. To contribute translations, follow these steps:
- Visit the Crowdin project page.
- Log in or sign up for a Crowdin account.
- Select the language you want to contribute to.
- Translate the content directly on the Crowdin platform.
- Your translations will be reviewed and integrated into the project.
This documentation was created with the power of MkDocs and styled using the awesome Material Theme. The simplicity and elegance of MkDocs combined with the Material Theme's modern design make for an excellent documentation experience.
Feel free to explore, contribute, and help us improve these docs! 🚀
If you have any questions, need assistance, or want to discuss anything related to the project, don't hesitate to join our Discord community at Discord. We're here to help and excited to connect with you!
Happy documenting! 📝