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).