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

Haddock all the things! #27

Open
chshersh opened this issue Jun 13, 2022 · 4 comments
Open

Haddock all the things! #27

chshersh opened this issue Jun 13, 2022 · 4 comments
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers

Comments

@chshersh
Copy link
Owner

chshersh commented Jun 13, 2022

Lots of functions are missing the documentation. It would be great to add more!

This issue is an excellent way to start contributing to Iris 🤗

See a function that doesn't have a proper explanation? Feel free to add it and it would be especially great if you can add a doctest example! 👏🏻

You can document as many functions as you want in a single PR, or you can open multiple PRs. This issue is a call for contributors 😊

The following documentation changes are especially appreciated:

  • Typos, spelling and grammar fixes
  • Adding doctest-like usage examples
  • Explanations on how to use functions and when
  • Documentations to data type fields
  • Docs to function arguments and result types
  • Anything else!

image

@chshersh chshersh added the documentation Improvements or additions to documentation label Jun 13, 2022
@chshersh chshersh added this to the v0.0.0.0: Big launch milestone Jun 13, 2022
@chshersh chshersh moved this to Todo in Iris Project Jun 13, 2022
@chshersh chshersh removed this from the v0.0.0.0: Initial Launch milestone Jun 25, 2022
@chshersh chshersh changed the title Add Haddock to every function Haddock all the things Jun 25, 2022
@chshersh chshersh changed the title Haddock all the things Haddock all the things! Jul 2, 2022
@chshersh chshersh added the good first issue Good for newcomers label Aug 8, 2022
@chshersh chshersh added the hacktoberfest https://hacktoberfest.com/ label Sep 27, 2022
@InfiniteVerma
Copy link

I'd like to work on this.

@chshersh
Copy link
Owner Author

chshersh commented Oct 6, 2022

@InfiniteVerma go for it! 👍🏻

Note, that you don't need to document everything in a single PR. You can document only some bits. Every contribution helps the project 😌

@InfiniteVerma
Copy link

@chshersh I'm attempting to add a doctest to a function. I would like to know if one can test a function that returns IO.

@chshersh
Copy link
Owner Author

chshersh commented Oct 9, 2022

@InfiniteVerma You can test IO functions as well with doctest. The official documentation has an example:

@chshersh chshersh removed the hacktoberfest https://hacktoberfest.com/ label Feb 28, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers
Projects
No open projects
Status: Todo
Development

No branches or pull requests

2 participants