-
-
Notifications
You must be signed in to change notification settings - Fork 349
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
[v2][Enhancement] Improve project and code documentation using LLMs #207
Comments
I would love to work on this enhancement. |
Hey @chirag4862, good to hear that! Docs are crucial for a good adoption of the OMRChecker and I hope you'll be able to help them improve. Please go through the current wiki and share which part of it you'd like to work on. |
@Udayraj123 we can improve documentation by following steps
Also I would like to work on this issue since. |
This is awesome. I'm assigning the task to you. Let me know if you need any clarification. Let's do it file by file I suppose. One more pointer is the schema/code differences in dev vs master branch. I think you can proceed by documenting the dev branch code since I will be releasing the v2 soon. |
Unassigning due to unavailability, discussed in discord |
Hi Uday, I would like to work on this project where I would like to supply the files to a GPT model along with what each file does. |
hey @fa-anony-mous, that looks like an interesting approach. I'll assign the task to you and you can host sample docs in your fork of the OMRChecker repository. Based on how it looks we can proceed with any review changes if required |
thank you @Udayraj123 . As more code gets pushed into it, I would like to add a feature where you could go this application and ask the AI to refine or comment where necessary and later maybe you can look at it and review the changes. If that's the case, I will ask to enter google api studio key as their new model gemini 2.0 flash model has upto 1M tokens for free daily. I can add other options for LLM app keys as well. Let me know what do you think about this? |
Sure, we can discuss more on that later. It looks like a cool idea! |
hi @Udayraj123 I have added the docugen generator, i have tested out some outputs on some sample files. It works well. |
@fa-anony-mous thanks, I'll try to check it by next week! |
Added a few comments. I'd appreciate if you could share the documentation output on OMRChecker using the PR you created. Can you please share a sample somewhere in this PR or as an attachment? Also we need to discuss and figure out how the documentation should update progressively on updating the source code(via new PRs) |
Is your feature request related to a problem? Please describe.
LLMs like ChatGPT can help make our project documentation easier to understand and fill any missing gaps.
Describe the solution you'd like
We should leverage code understanding capabilities of the LLMs to greatly improve documentation. We can -
Describe alternatives you've considered
Developers have to refer to the provided samples to learn how to use each of the flags present in our template/evaluation schemas
Additional context
We are also planning to move it into a dedicated docs/pages folder in future. Also exploring using docs generators like Docusaurus for more elaborate project and code documentation.
Note: please share your queries and approaches on discord for quicker discussions:
The text was updated successfully, but these errors were encountered: