www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Please document packages/libraries before putting them on dub registry

reply aberba <karabutawotld gmail.com> writes:
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.
Aug 04 2017
parent solidstate1991 <laszloszeremi outlook.com> writes:
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).
Aug 05 2017