3.3 KiB
Welcome to DocsGPT Contributing Guidelines
Thank you for choosing to contribute to DocsGPT! We are all very grateful!
🎉 Join the Hacktoberfest with DocsGPT and Earn a Free T-shirt! 🎉
We accept different types of contributions
📣 Discussions - Engage in conversations, start new topics, or help answer questions.
🐞 Issues - This is where we keep track of tasks. It could be bugs,fixes or suggestions for new features.
🛠️ Pull requests - Suggest changes to our repository, either by working on existing issues or adding new features.
📚 Wiki - This is where our documentation resides.
🐞 Issues and Pull requests
We value contributions in the form of discussions or suggestions. We recommend taking a look at existing issues and our roadmap.
Before creating issues, please check out how the latest version of our app looks and works by launching it via Quickstart the version on our live demo is slightly modified with login. Your issues should relate to the version that you can launch via Quickstart.
👨💻 If you're interested in contributing code, here are some important things to know:
Tech Stack Overview:
-
🌐 Frontend: Built with React (Vite) ⚛️,
-
🖥 Backend: Developed in Python 🐍
🌐 If you are looking to contribute to frontend (⚛️React, Vite):
- The current frontend is being migrated from
/application
to/frontend
with a new design, so please contribute to the new one. - Check out this milestone and its issues.
- The Figma design can be found here.
Please try to follow the guidelines.
🖥 If you are looking to contribute to Backend (🐍 Python):
- Review our issues and contribute to
/application
or/scripts
(please disregard oldingest_rst.py
ingest_rst_sphinx.py
files; they will be deprecated soon). - All new code should be covered with unit tests (pytest). Please find tests under
/tests
folder. - Before submitting your Pull Request, ensure it can be queried after ingesting some test data.
Testing
To run unit tests from the root of the repository, execute:
python -m pytest
Workflow 📈 :
- Fork repository
- Make the required changes on your forked version
- Commit those changes and submit those as a pull request so that it reflects on thr main repository.
Questions/collaboration
Feel free to join our Discord. We're very friendly and welcoming to new contributors, so don't hesitate to reach out.