Hacker News new | ask | show | jobs
by patmorgan23 780 days ago
Yes, those are two different kinds of documents for two different audiences.

You need both a java doc style big 'ol list of every function and what they do, and a narrative/workflow/primer based section of you documention