diff options
author | kotfu <kotfu@kotfu.net> | 2019-11-29 22:38:09 -0700 |
---|---|---|
committer | kotfu <kotfu@kotfu.net> | 2019-11-29 22:38:09 -0700 |
commit | 4bc02bb8b33c6d15e1e65ba68608c5b1cc678411 (patch) | |
tree | fe35cfbf055600eeb5b48cf0faa00105fa2365d9 /docs/doc_conventions.rst | |
parent | 309f542d5de2d357a64bcbf0a8bdb1d90918fb0f (diff) | |
download | cmd2-git-4bc02bb8b33c6d15e1e65ba68608c5b1cc678411.tar.gz |
Clean out some unused cruft
Diffstat (limited to 'docs/doc_conventions.rst')
-rw-r--r-- | docs/doc_conventions.rst | 24 |
1 files changed, 5 insertions, 19 deletions
diff --git a/docs/doc_conventions.rst b/docs/doc_conventions.rst index 226c5edc..fc60e08d 100644 --- a/docs/doc_conventions.rst +++ b/docs/doc_conventions.rst @@ -108,7 +108,7 @@ extension. This allows you to reference any header in any document by:: See :ref:`features/argument_processing:Help Messages` -or :: +or:: See :ref:`custom title<features/argument_processing:Help Messages>` @@ -121,24 +121,10 @@ and See :ref:`custom title<features/argument_processing:Help Messages>` -Autolinking ------------ - - Referencing cmd2 API documentation ---------------------------------- -[TODO what's the right way to link to source code? Can we make it link to the -tag that the documentation is rendered from?] - -It's easy to reference and create a link to the API documentation for classes, -methods, functions, or attributes. - - -Referencing Methods -~~~~~~~~~~~~~~~~~~~ - -To reference a method, use one of the following approaches: +To reference a method or function, use one of the following approaches: 1. Reference the full dotted path of the method:: @@ -193,9 +179,9 @@ Info and Warning Callouts Wrapping -------- -Hard wrap all text with line lengths no greater than 79 characters. It makes -everything easier when editing documentation, and has no impact on reading -documentation because we render to html. +Hard wrap all text so that line lengths are no greater than 79 characters. It +makes everything easier when editing documentation, and has no impact on +reading documentation because we render to html. Referencing cmd2 |