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