oss-reva / gitscribe

discord bot for github repo and issue info retrieval.
https://pypi.org/project/gitscribe/
MIT License
9 stars 12 forks source link

docs: Create Codebase Explanation in "docs/" Folder #9

Open virajsazzala opened 1 year ago

virajsazzala commented 1 year ago

Create Codebase Explanation in "docs/" Folder

Feature Summary

This proposal suggests the creation of comprehensive codebase documentation within a new "docs/" folder in the "gitscribe" repository. The documentation will provide clear insights into the code's architecture, components, functions, and guidelines for contributors and users.

Motivation

The motivation behind this documentation initiative is to enhance project transparency, foster collaboration, and facilitate a deeper understanding of the "gitscribe" bot's codebase. Documentation is essential for developers, contributors, and users seeking to explore and customize the bot effectively.

Use Case

The documentation will serve as a valuable resource for new contributors looking to join the project, users facing issues, and anyone interested in gaining a comprehensive understanding of the "gitscribe" codebase. It will streamline the onboarding process and empower users to troubleshoot and customize with confidence.

Current Behavior

The "gitscribe" repository currently lacks organized code documentation, making it challenging for newcomers and users to navigate and understand the codebase thoroughly.

Proposed Behavior

This proposal suggests the creation of a dedicated "docs/" folder within the repository. The folder will contain well-structured documentation that explains the code's architecture, the purpose of major components, detailed function explanations, and guidelines for contribution. This documentation will be a living resource, continuously updated to reflect changes in the codebase.

Additional Information

The establishment of a "docs/" folder housing codebase documentation is a significant step toward maintaining a healthy and growing open-source project. It fosters accessibility, encourages collaboration, and empowers users and contributors alike.

Related Issues

None at present.

Gun2902 commented 1 year ago

i can help u with this

virajsazzala commented 1 year ago

@Gun2902 Yes, you can work on this!