Those packages without documentation might be useful but no one except you will use it because only you know how and what it does. We spend hours writing code but can't spend minutes getting people to use them.

Intro
Purpose
Usage
...
To do
Contributions

Basic stuff.

On Saturday, 5 August 2017 at 00:08:29 UTC, aberba wrote:
> Those packages without documentation might be useful but no one except you will use it because only you know how and what it does. We spend hours writing code but can't spend minutes getting people to use them.
>
> Intro
> Purpose
> Usage
> ...
> To do
> Contributions
>
> Basic stuff.

I'm currently working on this alongside with my code.

Tip: Name all your variables after what they supposed to do, this further helps understanding your code. Using "foo" and "bar" might be trendy among programmers, but it can ruin code readability (to the point I once had to completely rewrite an algorithm instead of simply updating it).

Also can I skimp out on details if a certain function only supposed to simply return a value (eg. getters, I usually write some warnings for setters even if they're pretty short).