From bba7b1889b7c3e97a01e6bf774f1399b3e8778b1 Mon Sep 17 00:00:00 2001 From: Akeeb4316 <93240229+Akeeb4316@users.noreply.github.com> Date: Wed, 25 Sep 2024 23:14:57 -0400 Subject: [PATCH 1/3] Update README.md --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/README.md b/README.md index 7e188ef..17ee53c 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,33 @@ The goal is to produce a [Manim Plugin](https://www.manim.community/en/stable/pl ## Contributing For information on how to contribute to this project, please see [CONTRIBUTING.md](CONTRIBUTING.md). +## Installation Instructions +To install the project and its dependencies, follow these steps: +1. Clone the repository: + ```bash + git clone https://github.com/your-repo-link.git +2. Navigate to the project directory: + cd your-project-directory +3. Install the required dependencies using pip: + pip install -r requirements.txt + +Once installed, you can run the project by executing the following command: +python mlinearcollection.py + +For detailed usage examples, refer to the following sections in the documentation: +-Arrays +-Variables + +## Building the Documentation +This project uses Sphinx for generating its documentation. To generate the HTML documentation locally, follow these steps: + +1. Navigate to the docs directory: + cd docs +2. Build the documentation using the Makefile: + make html +3. The documentation will be available at _build/html/index.html. Open it in a web browser to view the project documentation. + + ## Resources Links - [Getting Started](https://docs.manim.community/en/stable/installation.html) - [Official Manim Community Documentation](https://docs.manim.community/en/stable/) From d2e791798dde9bec442beecb8760ac492168edc2 Mon Sep 17 00:00:00 2001 From: Akeeb4316 <93240229+Akeeb4316@users.noreply.github.com> Date: Wed, 25 Sep 2024 23:25:17 -0400 Subject: [PATCH 2/3] Update CONTRIBUTING.md --- CONTRIBUTING.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e5745d5..359997c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -31,6 +31,23 @@ git push origin dev ### Initiate a PR Once you have finalized your contribution, navigate to this [link](https://github.com/ufosc/manim-data-structures/pulls) to create a new pull request and submit it. +## Contributing to Documentation +We welcome contributions to improve the project's documentation. To contribute, follow these steps: + +Edit or add new .rst files in the docs directory as needed. + 1. To preview your changes, generate the documentation using the following command: + 2. make html + 3. Review the generated HTML in _build/html/index.html to ensure the documentation is + formatted correctly. + 4. Submit a pull request with a description of the changes made. + +## Coding Standards +Please ensure that your code follows our style guidelines. We use flake8 for linting. To run linting checks, use: + +flake8 your-code-file.py + +All code contributions should pass the linting checks before submitting a pull request. + ### Closing note Once your PR is approved, it will be merged into the `dev` branch and we are looking at eventually merging upstream. From 84434961d1278ca4f79befe4f9467b32f79443ab Mon Sep 17 00:00:00 2001 From: Akeeb4316 <93240229+Akeeb4316@users.noreply.github.com> Date: Wed, 25 Sep 2024 23:36:29 -0400 Subject: [PATCH 3/3] Update PULL_REQUEST_TEMPLATE documentation.md --- .github/PULL_REQUEST_TEMPLATE/documentation.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.github/PULL_REQUEST_TEMPLATE/documentation.md b/.github/PULL_REQUEST_TEMPLATE/documentation.md index 155e691..dac3a3d 100644 --- a/.github/PULL_REQUEST_TEMPLATE/documentation.md +++ b/.github/PULL_REQUEST_TEMPLATE/documentation.md @@ -17,6 +17,10 @@ release. Write RST between the following start and end comments.--> ## Checklist - [ ] I have read the [Contributing Guidelines](https://github.com/drageelr/manim-data-structures/blob/main/CONTRIBUTING.md) - [ ] I have written a descriptive PR title (see top of PR template for examples) +- [ ] Code changes are well-documented. +- [ ] Any new .rst files have been added to the documentation. +- [ ] All dependencies are listed in requirements.txt if necessary. +- [ ] All linting checks have been run and passed. ## Reviewer Checklist