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

Improve Code Documentation for the Project #107

Open
Hermann-Core opened this issue Jul 1, 2024 · 0 comments
Open

Improve Code Documentation for the Project #107

Hermann-Core opened this issue Jul 1, 2024 · 0 comments
Assignees

Comments

@Hermann-Core
Copy link
Collaborator

Hermann-Core commented Jul 1, 2024

The codebase lacks proper documentation, which makes it difficult to implement additional features. We often need to dig through the code to understand how it functions before we can use certain dependencies.

Proposal:

  1. Document existing code
  • Add docstrings to all public structs, enums, traits, and functions.
  • Include examples where applicable to demonstrate usage.
  • Add module-level comment explaining their purpose and functionality.
  • Write inline comments to explain non-obvious parts of the code.
  1. Update crate-level README
  • Enhance the README file to provide a clear introduction to the package.
  • Include installation and usage instructions.
  • Add links to the detailed documentation where applicable.
  1. Generate API documentation
  • Use the built-in tools like cargo docs to automatically generate and open the API documentation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

When branches are created from issues, their pull requests are automatically linked.

2 participants