Confirmed users
564
edits
Platform/GFX/DesignDocumentationGuidelines: Difference between revisions
Jump to navigation
Jump to search
Platform/GFX/DesignDocumentationGuidelines (view source)
Revision as of 19:54, 14 April 2014
, 14 April 2014→In a separate file in the gfx/docs directory
Msreckovic (talk | contribs) |
Msreckovic (talk | contribs) |
||
| Line 22: | Line 22: | ||
=== In a separate file in the gfx/docs directory === | === In a separate file in the gfx/docs directory === | ||
* Name the documentation file appropriately, use the .md extension (assuming it is markdown | * Name the documentation file appropriately, use the .md extension (assuming it is markdown) | ||
* Use the markdown syntax (and if not, make sure you understand why not) | * Use the markdown syntax (and if not, make sure you understand why not) | ||
* Put the text between quotes (but not including them) "\page pagenameinlowercase Page Title Text" as the first line in your .md file | |||
* The source file could/should contain a pointer to the documentation, and vice versa. | * The source file could/should contain a pointer to the documentation, and vice versa. | ||
* The documentation file may reference classes or files themselves: | * The documentation file may reference classes or files themselves: | ||
| Line 31: | Line 32: | ||
** SomeClassFile.h | ** SomeClassFile.h | ||
* The source (or other external files) may reference the documentation file: | * The source (or other external files) may reference the documentation file: | ||
** [this way](@ref | ** [this way](@ref pagenameinlowercase) | ||
* Good because: | * Good because: | ||
** The documentation is versioned | ** The documentation is versioned | ||