This commit is contained in:
2025-10-19 16:21:44 +03:00
parent dcbe03d08a
commit 67ac8c53ca
+9 -9
View File
@@ -141,12 +141,12 @@ To get started with your first code contribution, please follow these steps to s
1. Fork the `Argenta` repository on GitHub. 1. Fork the `Argenta` repository on GitHub.
2. Clone your forked repository to your local machine: 2. Clone your forked repository to your local machine:
``` ```bash
git clone https://github.com/<YOUR_USERNAME>/Argenta.git git clone https://github.com/<YOUR_USERNAME>/Argenta.git
cd Argenta cd Argenta
``` ```
3. Create and activate a Python virtual environment. 3. Create and activate a Python virtual environment.
``` ```bash
# For macOS/Linux # For macOS/Linux
python3 -m venv .venv python3 -m venv .venv
source .venv/bin/activate source .venv/bin/activate
@@ -156,24 +156,24 @@ To get started with your first code contribution, please follow these steps to s
.venv\Scripts\activate .venv\Scripts\activate
``` ```
4. Install the project dependencies, including the development tools. 4. Install the project dependencies, including the development tools.
``` ```bash
pip install -e .[dev] pip install -e .[dev]
``` ```
5. Set up the pre-commit hooks to automatically check your code for style and quality before you commit. 5. Set up the pre-commit hooks to automatically check your code for style and quality before you commit.
``` ```bash
pre-commit install pre-commit install
``` ```
6. Create a new branch for your feature or bug fix. Use a descriptive name, like `fix/login-bug` or `feat/new-widget`. 6. Create a new branch for your feature or bug fix. Use a descriptive name, like `fix/login-bug` or `feat/new-widget`.
``` ```bash
git checkout -b your-new-branch-name git checkout -b your-new-branch-name
``` ```
7. Make your changes! Write your code, and don't forget to add or update tests for your changes. 7. Make your changes! Write your code, and don't forget to add or update tests for your changes.
8. Run the test suite to ensure everything is working correctly. 8. Run the test suite to ensure everything is working correctly.
``` ```bash
pytest pytest
``` ```
9. Commit your changes following our commit message styleguide and push them to your fork. 9. Commit your changes following our commit message styleguide and push them to your fork.
``` ```bash
git add . git add .
git commit -m "feat(widget): add the new super widget" git commit -m "feat(widget): add the new super widget"
git push origin your-new-branch-name git push origin your-new-branch-name
@@ -188,11 +188,11 @@ To improve the documentation, you can follow a similar workflow as for code cont
1. Ensure your development environment is set up as described in the "Your First Code Contribution" section. 1. Ensure your development environment is set up as described in the "Your First Code Contribution" section.
2. Navigate to the documentation directory. 2. Navigate to the documentation directory.
``` ```bash
cd docs cd docs
``` ```
3. To build the documentation locally and see your changes, run: 3. To build the documentation locally and see your changes, run:
``` ```bash
make html make html
``` ```
4. Open `_build/html/index.html` in your web browser to preview the generated documentation. 4. Open `_build/html/index.html` in your web browser to preview the generated documentation.