diff --git a/writingdoc/structure.html b/writingdoc/structure.html index 900f2a6..b631785 100644 --- a/writingdoc/structure.html +++ b/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.

+ +

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.

Standards Conforming Documentation