chshersh/iris

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!

image

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: