diff --git a/writingdoc/structure.html b/writingdoc/structure.html index af38aa8..d4b747a 100644 --- a/writingdoc/structure.html +++ b/writingdoc/structure.html @@ -111,19 +111,22 @@ suggest the following guidelines for Boost library documentation.
+The documentation structure required for the standard is an effective way to describe the technical specifications for a library. Although terse, that format is familiar to many Boost - users and is far more precise than most ad hoc formats. Below - is a description of the Standard documentation structure. Note + users and is far more precise than most ad hoc formats. + This section (apart from the introduction) is taken from the + C++ standard's method of description (Section 17.3). The + following section fleshes this out with + more detail. Note that Standard proposals must include full standardese wording, which the committee will not do for you, to be accepted. That level of detail is not expected of Boost library documentation.
-Each document contains the following elements, as applicable