rust-algorithms icon indicating copy to clipboard operation
rust-algorithms copied to clipboard

Add documentation

Open alexfertel opened this issue 4 years ago • 12 comments

We want to document each class of algorithms. This comes in two flavors:

  • Adding README files to each directory holding a class of algorithms, for example, sorting.
  • Adding documentation comments to each of the algorithms.

You can find examples of documentation comments here.

General guidelines for the explanations are:

  • Be concise. Keep in mind these algorithms are meant for educational purposes.
  • Link to the bibliography.
  • Images are better than no images.
  • If it is possible, include time and space complexities.

alexfertel avatar Jul 06 '21 21:07 alexfertel

Do you still need help for the documentation of the algorithms?

robbespo00 avatar Apr 07 '23 17:04 robbespo00

Do you still need help for the documentation of the algorithms?

Yes, we do! You can just choose whatever algo you want and document it the best you can.

alexfertel avatar Apr 10 '23 10:04 alexfertel

As I see many folders (string, sorting for example) have already had README file in their directory. Are they good or we still able to revise and improve them?

0xVitalii avatar May 31 '23 18:05 0xVitalii

As I see many folders (string, sorting for example) have already had README file in their directory. Are they good or we still able to revise and improve them?

Yes! Please feel free to submit improvements wherever you may see fit! @tvcapital

alexfertel avatar May 31 '23 19:05 alexfertel

Is there still any help needed? I would like to contribute u can contact me on [email protected]

patilniraj8 avatar Aug 11 '23 03:08 patilniraj8

Is there still any help needed?

Yes! Feel free to open PRs adding docs wherever you may see fit! 👍🏻 @patilniraj8

alexfertel avatar Aug 11 '23 07:08 alexfertel

Ok I would like to work on it thanks

On Fri, 11 Aug, 2023, 1:17 pm Alexander González, @.***> wrote:

Is there still any help needed?

Yes! Feel free to open PRs adding docs wherever you may see fit! 👍🏻 @patilniraj8 https://github.com/patilniraj8

— Reply to this email directly, view it on GitHub https://github.com/alexfertel/rust-algorithms/issues/8#issuecomment-1674338710, or unsubscribe https://github.com/notifications/unsubscribe-auth/A2G36VTCWOAAARABCA2Z5VTXUXPPXANCNFSM475L2YUQ . You are receiving this because you were mentioned.Message ID: @.***>

patilniraj8 avatar Aug 17 '23 05:08 patilniraj8

Can u please review the pull request i created just now

patilniraj8 avatar Sep 30 '23 15:09 patilniraj8

I have written up ReadMe.md's for the General and Graphs folders. Tomorrow I plan to write one for the Math's folder and submit a PR.

jackattack825 avatar Jun 10 '24 23:06 jackattack825

Worked on the readme.md for bit manipulation. Can you review my PR #72 in addition of I made some changes for readability.

aditya-nv-06 avatar Jun 16 '24 05:06 aditya-nv-06