std.datetime is too big

Jacob Carlborg doob at me.com
Mon Nov 7 07:22:01 PST 2011


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


More information about the Digitalmars-d mailing list