Added links to the writing documentation pages.

[SVN r13199]
This commit is contained in:
William E. Kempf 2002-03-14 23:30:00 +00:00
parent 933a719686
commit c6d34f706b
2 changed files with 10 additions and 4 deletions

View File

@ -38,6 +38,10 @@ content="text/html; charset=iso-8859-1">
<p><a href="lib_guide.htm"><b>Library Requirements and <p><a href="lib_guide.htm"><b>Library Requirements and
Guidelines</b></a>.&nbsp; Basic standards for those preparing Guidelines</b></a>.&nbsp; Basic standards for those preparing
a submission.</p> a submission.</p>
<p><a href="writingdoc\index.html"><strong>Writing
Documentation for Boost</strong></a> Basic guidelines
for writing documentation and templates for quickly generating
documentation that follows the guidelines.</p>
<p><a href="test_policy.htm"><b>Test Policy and Protocols</b></a>.&nbsp; <p><a href="test_policy.htm"><b>Test Policy and Protocols</b></a>.&nbsp;
How testing works at Boost.</p> How testing works at Boost.</p>
<p><a href="submission_process.htm"><b>Library Submission <p><a href="submission_process.htm"><b>Library Submission

View File

@ -263,18 +263,20 @@ C++ programmer to use the library successfully?</p>
<li>General introduction to the library.</li> <li>General introduction to the library.</li>
<li>Description of each class.</li> <li>Description of each class.</li>
<li>Relationship between classes.</li> <li>Relationship between classes.</li>
<li>For each function, as applicable, description, requirements <li>For each function, as applicable, description, requirements (preconditions),
(preconditions), effects, post-conditions, returns, and throws.</li> effects, post-conditions, returns, and throws.</li>
<li>Discussion of error detection and recovery strategy.</li> <li>Discussion of error detection and recovery strategy.</li>
<li>How to use including description of typical uses.</li> <li>How to use including description of typical uses.</li>
<li>How to compile and link.</li> <li>How to compile and link.</li>
<li>How to test.</li> <li>How to test.</li>
<li>Version or revision history.</li> <li>Version or revision history.</li>
<li>Rationale for design decisions.&nbsp; See <a href="#Rationale">Rationale <li>Rationale for design decisions.&nbsp; See <a href="#Rationale">Rationale
rationale</a>.</li> rationale</a>.</li>
<li>Acknowledgements.&nbsp; See <a href="#Acknowledgements">Acknowledgments <li>Acknowledgements.&nbsp; See <a href="#Acknowledgements">Acknowledgments
rationale.</a></li> rationale.</a></li>
</ul> </ul>
<p>If you need more help with how to write documentation you can check out the
article on <a href="writingdoc/index.html">Writing Documentation for Boost</a>.</p>
<h2>Rationale</h2> <h2>Rationale</h2>
<p>Rationale for some of the requirements and guidelines follows.</p> <p>Rationale for some of the requirements and guidelines follows.</p>
<hr> <hr>