Changes between Version 5 and Version 6 of StandardCppLibraryDocumentation


Ignore:
Timestamp:
Jul 16, 2007, 11:42:23 PM (15 years ago)
Author:
Andrew Sutton
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • StandardCppLibraryDocumentation

    v5 v6  
    1818[[Image(standard_cpp_boosted_documentation.png,nolink)]]
    1919
    20 In construction!
     20The goal of this documentary subproject is to produce concept and reference documentation for the Standard Template Library. Although much of this is very nicely documented and made available by [http://www.sgi.com/tech/stl/ SGI], there are several reasons that Boost should provide a set of documents under its own umbrella. As a stated goal in the Boost charter, "We aim to establish 'existing practice'" and many libraries documents espouse "Best Practices". This project falls under these auspices. This project aims to establish existing practice for providing concept and reference documetnation for C++ libraries.
     21
     22Additional benefits in developing these documents include, a) a unified look and feel for ST+Boost documents and b) closer control over their content and presentation of the information. Essentially, this gives us a chance to work out more effective ways of presenting concept and reference material - which could be interesting with concepts becoming a major part of the new C++0x standard.
     23
     24Most documentation for generic libraries can be cleanly divided into two different parts: concept documents and reference documents.
     25
     26== Concept Documents ==
     27Concepts documents describe the requirements on types (both built-in and user-defined) in order for them to be used with classes and functions provided by the library.
     28
     29== Reference Documents ==
     30Reference documents defines the actual types and functions used by developers. Despite common practice reference documentation should be more than simply listing namespaces, classes, and functions. Good reference documents should provide examples and advice for "Best Practices".
    2131
    2232----