AI generated documentation for Nox

[nestordemeure]

Hi!

Would you be interested in a PR adding AI-generated documentation to the types, traits, and functions in Nox? It would be manually checked by a human (me) who has knowledge of Jax and Rust but not this particular codebase.

I have run some quick tests and the output seem serviceable, definitely not perfect but a good starting point to be tweaked by people familiar with the codebase before merging.

[akhilles]

Hey @nestordemeure, we're certainly open to it but it depends heavily on the quality of the generated comments. Could we start with a small submodule and then review it?

My general preference for code comments is to not be overly verbose wrt. information that can easily be inferred from the function signature. Comments that explain complex/unintuitive behavior are the most welcome.

[nestordemeure]

Do you have a submodule you would recommend? I could then make a PR to have comments to discuss.

[sphw]

Do you have a submodule you would recommend? I could then make a PR to have comments to discuss.

Could you try on the tensor module?

[nestordemeure]

Will do and keep you posted once the PR is up :)

[nestordemeure]

I think the tensor.rs trial was a success. My suggestion would be to keep going one file at a time (that way you have time to review the comments without being overwhelmed). In which case, in which order would you like me to cover the Nox files?

[akhilles]

1 PR for the rest of the module is fine, and somewhat preferable. Reviewing it isn't a concern.

[nestordemeure]

I have added a PR covering the full Nox library. That was a lot of comments and will definitely take some time to review but it looks like an acceptable basis to document the code.

[akhilles]

I have added a PR covering the full Nox library. That was a lot of comments and will definitely take some time to review but it looks like an acceptable basis to document the code.

Thanks! Will try review it today or tomorrow.