On Jan 24, 2010, at 11:39 AM, Hannes Magnusson wrote:
>> Another great example that shows how difficult it can be to read 
>> documentation that's littered with version history. The CLI docs border on 
>> being unreadable.
>> 
>> We don't have a nice way to list changelog history yet (for non-functions) 
>> but it seems possible. A table? Adding version information on top feels 
>> difficult considering all the different changes. Like for CLI, was it born 
>> with 4.3 or 4.2? Difficult to say, but an explicit changelog would clear 
>> that up.
> Adopting the function changelogs seems like the simplest way the the
> added sideaffect of giving a consistent look.


+1

-- Gwynne

Reply via email to