Inspired by discussion in a Julia Discourse thread, this repo is meant to help organize community efforts to enrich Julia's function documentation.
The first call to action was at https://discourse.julialang.org/t/coordinating-community-efforts-to-enrich-function-docs/80338 and we will post follow ups in the future.
- Suggest functions that need more or different documentation.
- Participate in a pairing exercise where you either help write proposed documentation or you help read proposed documentation to provide something that is more accessible.
Non-exhaustively, it's useful for a function to contain:
- Description: A 1-3 sentence summary of what the function/method does.
- Usage: A theoretical call to the function/method with all arguments.
- Arguments: A list of all arguments, their types and their meaning.
- Returned Values: A list of all returned values, their types and their meaning.
- Details: More details about how the function/method works, how it should be called, how it is implemented, how its returned values are meant to be used, etc.
- References: Bibliographic information
- See Also: Other documentation sections that are relevant and text explaining their relationship to the current function/method.
- Examples: Specific examples that show what using the function/method in practice would look like.