new documentation format for std.algorithm

[spir]

On 02/02/2011 05:44 PM, Adam Ruppe wrote:
> I also moved the brief description from the table to the first
> line of the ddoc. The ddoc spec already describes the first paragraph
> as being a summary, with the following paragraphs as a separate
> description<http://digitalmars.com/d/2.0/ddoc.html>, so we're
> just leveraging that existing definition.

I think that's just the-right-thing. Same principle may even be the default for 
most modules, don't you think? Thus allowing to generate summary tables of 
module functionality close to the top of generated html pages. This would also 
encourage authors writing sensible (first-line) summaries, properly telling the 
/purpose/ of each feature.

Denis
-- 
_________________
vita es estrany
spir.wikidot.com