Haddock all the things!
chshersh opened this issue ยท 4 comments
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!
I'd like to work on this.
@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 ๐
@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.
@InfiniteVerma You can test IO functions as well with doctest
. The official documentation has an example: