This is the mail archive of the libstdc++@sourceware.cygnus.com mailing list for the libstdc++ project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: docs directory plan


>>>>> "BK" == Benjamin Kosnik <bkoz@cygnus.com> writes:

BK> So here's a preliminary plan: the root level of the libstdc++
BK> directory will contain a docs directory. Inside this directory will be
BK> three new sub-directories: text, html, and image (all names pending,
BK> by the way.) 

This is the "generic" way of splitting, as opposed to the "semantic"
way.

It means that depending upon whether some given information is in text
or in html --which the person needing the information cannot guess in
advance--, it will be found in various places.

It means also that the risk to have duplicates in different formats,
possibly out of step with each other, is higher, and more difficult to
track.

I'd recommend doing the contrary and classify along the contents.

My 2 cents.
Best Regards!
Marc

-- 
Marc Girod                Hiomo 5/1          Voice:  +358-9-511 23746
Nokia Telecommunications  P.O. Box 320       Mobile: +358-40-569 7954
NWS/NMS/NMS for Data      00045 NOKIA Group  Fax:    +358-9-511 23580
                          Finland            marc.girod@ntc.nokia.com


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]