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, an

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