DocsGPT/CONTRIBUTING.md
2023-10-10 18:05:19 +05:30

2.9 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.

If you're interested in contributing code, here are some important things to know:

We have a frontend built with React (Vite) and a backend 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 old ingest_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.

Thank you so much for considering contributing to DocsGPT!🙏