Skip to content

Style Guide: SCDocs (.schelp)

Michael McCrea edited this page Oct 20, 2023 · 1 revision

The following guidelines apply to schelp files in /HelpSource.

Tag capitalization

Prefer using the lowercase forms of tags (code:: ::, method::), unless this would break with convention in the context being edited.

Indentation

Use tabs for indentation, both for schelp-formatted text and code examples.

Private methods

Hide all of a class's private methods using private::.

Method documentation

Prefer using argument:: and returns:: instead of the method description body to document parameters and return values.

Either all of the parameters and/or return value should be documented, or none should be.

When documenting a parameter or return value, make sure to include the expected type.