Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Feature]: Code Documentation #10

Open
1 task done
smh812xyz opened this issue Jun 17, 2023 · 0 comments
Open
1 task done

[Feature]: Code Documentation #10

smh812xyz opened this issue Jun 17, 2023 · 0 comments
Assignees
Labels
code documentation Augment comments and/or developer documentation
Milestone

Comments

@smh812xyz
Copy link
Member

smh812xyz commented Jun 17, 2023

What are you trying to achieve?

Ensure well-documented source code in XigXog products.

What would you like to see in the product?

Provide meaningful, helpful source code comments and documentation enabling other developers - both in the open source community and internal to XigXog - to understand not just what the code does, but more importantly, how it does it. The goal is for a developer to be able to review the code and understand its behavior by reading through the comments and documentation.

Give us an idea of the benefit to you and others should we fulfill the request

Good documentation and well-commented code will render the codebase more accessible, attract both employees and open source contributors and facilitate maintenance and extendability in the future. A succinct overview here: https://easternpeak.com/blog/source-code-documentation-best-practices/

Version

v0.4.x-alpha

Code of Conduct

  • I agree to follow XigXog's Code of Conduct
@smh812xyz smh812xyz added documentation Improvements or additions to documentation code documentation Augment comments and/or developer documentation and removed documentation Improvements or additions to documentation labels Jun 17, 2023
@smh812xyz smh812xyz added this to the v0.4.x milestone Jun 17, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
code documentation Augment comments and/or developer documentation
Projects
None yet
Development

No branches or pull requests

2 participants