StrepHit icon indicating copy to clipboard operation
StrepHit copied to clipboard

Improve documentation

Open marfox opened this issue 9 years ago • 2 comments

Missing features in the current Mediawiki page, as compared to what I consider a gold standard, i.e., http://docs.python-requests.org/en/latest/api/ ordered by priority:

  1. usage commands (only needed for prominent functions of the NLP pipeline, e.g., https://www.mediawiki.org/wiki/StrepHit#strephit.commons.pos_tag_module);
  2. arguments type, cf. https://www.mediawiki.org/wiki/StrepHit#strephit.annotation.post_job_module
  3. internal classes anchors;
  4. source code links;
  5. return type anchors/links.

marfox avatar Jun 01 '16 09:06 marfox

Points 3,4 and 5 above are to be implemented yet.

marfox avatar Jun 13 '16 15:06 marfox

More comments. These are the minimal requirements to make the documentation more usable:

  1. do not generate non-browsable lists, e.g., https://www.mediawiki.org/wiki/StrepHit#Subpackages
  2. avoid empty sections, e.g., https://www.mediawiki.org/wiki/StrepHit#Module_contents

marfox avatar Jun 13 '16 15:06 marfox