[Issue 14608] New: Enum members should be formatted as a table
via Digitalmars-d-bugs
digitalmars-d-bugs at puremagic.com
Tue May 19 09:12:32 PDT 2015
https://issues.dlang.org/show_bug.cgi?id=14608
Issue ID: 14608
Summary: Enum members should be formatted as a table
Product: D
Version: D2
Hardware: All
OS: All
Status: NEW
Severity: enhancement
Priority: P1
Component: websites
Assignee: nobody at puremagic.com
Reporter: andrei at erdani.com
Consider e.g.
http://dlang.org/phobos-prerelease/std_algorithm_searching.html#.OpenRight.
There, we have a lavishly laid itemization for only little content.
All enum values have one-word declarations and short descriptions. It would be
great if they were laid instead as a table (similar to "Params:") with two
columns (name and description). There should be no "Jump to" for the values.
The ddox-based documentation is actually worse - it generates one page per enum
value (see e.g.
http://dlang.org/library/std/algorithm/searching/open_right.no.html. Most of
those pages are fluff. Enums should be compressed to one page with all values
and their descriptions on it.
--
More information about the Digitalmars-d-bugs
mailing list