On 2011-11-07 14:14, Regan Heath wrote:
Sure, but that doesn't have to dictate the number of web pages we use to document D modules. I mean, std.datetime may be 1 file, but contain 5 classes (for example) and we can still choose to have 5 (or more) web pages, one for each class and all linked from a std.datetime top level page. Basically we want documentation that is easy to navigate, how it's done is completely up to us. I think multiple pages, and collapsible sections will make pages easier to navigate in general, and a consistent layout will aid in understanding also (for experienced readers) but, common sense can overrule this where appropriate - i.e. no sense having a collapsible section with a single line in it - for example. It would be nice if DDoc had the ability to make that decision, somehow - it might, I've not used it at all so far so I have no idea.
That's a good point. -- /Jacob Carlborg
