[Boost-bugs] [Boost C++ Libraries] #6538: property map documentation is overlay complicated

Subject: [Boost-bugs] [Boost C++ Libraries] #6538: property map documentation is overlay complicated
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2012-02-09 16:30:35

#6538: property map documentation is overlay complicated
------------------------------+---------------------------------------------
 Reporter:  anonymous         |       Owner:  dgregor     
     Type:  Tasks             |      Status:  new         
Milestone:  To Be Determined  |   Component:  property_map
  Version:  Boost 1.48.0      |    Severity:  Cosmetic    
 Keywords:  documentation     |  
------------------------------+---------------------------------------------
 The documentation of property map is overly complicated, for a few
 reasons:

 1. References to the Graph library. Considering that many readers of the
 documentation will be referred from the Graph library, they are being send
 in circles. Those not referred from the Graph library  won't be helped
 either.

 2. Too many indications of what property_map is similar to. These are
 generally not helpful: better to say what it is, than what it looks like.

 3. Complicated examples.

 I am attaching a rewrite of property_map.html

-- 
Ticket URL: <https://svn.boost.org/trac/boost/ticket/6538>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.