diff options
Diffstat (limited to 'more')
-rw-r--r-- | more/writingdoc/structure.html | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/more/writingdoc/structure.html b/more/writingdoc/structure.html index 900f2a61a8..b63178530b 100644 --- a/more/writingdoc/structure.html +++ b/more/writingdoc/structure.html @@ -116,6 +116,14 @@ by the standard. Boost libraries should also provided additional documentation, such as introductory, tutorial, example, and rationale material.</p> + + <p>Since the documentation is also intended to act as a web reference, it's a + good idea to add some extra information to individual pages, especially + detailed reference pages. Full C++ identifiers and required headers are + especially useful and often overlooked. Remember that individual pages might + be accessed directly from a search engine or link, so readers won't have seen + information from previous pages. In reference pages, it can be helpful to link + to relevant tutorial information.</p> <h2><a name="standards-conforming" id="standards-conforming">Standards Conforming</a> Documentation</h2> |