SECTION: The Webel Doc` package and the HelpF, HelpO`& HelpM` help registry packages

Icon class
icon_class_computed
far fa-bookmark
Tutorial
Keywords
Please make sure you've read the intro page about this highly technical trail on the Webel libraries for the Wolfram Language and SysML4Mathematica.

This previous section is a pre-requisite for fully understanding this section (although you might get the gist of it easily anyway):

This section introduces the Webel Doc` package (for highly structured and consistent ::usage String generation) and the HelpF` package for the Webel code-oriented function help registry, and the HelpO` package for the class and method help registry (which was the original impetus for creating the help registries approach).

Dr Darren says:

As far as I can tell there is no easy way of using the Mathematica ::usage help system with methods of MTools classes. And whilst ::usage can be created for TagSetDelayed as used for "methods" of Webel Abstract Data Type (ADT) stateless pseudo classes it can't be done in a method-specific way per ADT. If I am wrong about this you are most welcome to contact me via this form to relieve me of my possible ignorance.

In any case, these code-oriented Webel help packages have proven extremely useful for maintaining and documenting very complex applications, make heavy use of Single Source of Truth (SSOT) and Don't Repeat Yourself (DRY) principles, and add support for structured documentation of arguments and options.

Longer term, these packages could be extended to also generate full package documentation compliant with the Documentation Tools format, which is stored separate from (parallel to) the main code in Wolfram Language packets, and is not an inline code-oriented documentation system (compare with Javadoc). Visit also:

Start section here

Slides in this section

If you want to navigate the entire section including the additional explanatory text click on the title link of the first slide to view the full slide page, then use the next links to move through the slide pages. If you just want to view the slide images only in sequence, click on any slide to view it larger in a viewer, then click again to move through each slide in this tutorial trail section.
Next trail section