Fantastic work, Nick. It looks really great and the autosync will help in future. Doing this manually is an almost hopeless fight. ;)
Consistent output is IMHO important for a better orientation. I would even appreciate a capitalised output like in man pages, so USAGE, PURPOSE, and EXAMPLE. But all other consistant ways are good too. thx mue On Tue, Feb 3, 2015 at 1:08 PM, Nick Veitch <[email protected]> wrote: > Hello, > > I have just finished updating the all-new exciting and more comprehensible > commands reference page in the docs for 1.21.1: > > https://juju.ubuntu.com/docs/commands.html > > The more observant of you will notice that the content has almost all been > autogenerated directly from juju help. This is exciting (for me > anyway) because I have long yearned for these to sync better. Some > commands are better explained than others, and some could do with some > examples, but I can contribute those. > > Before I do that, I did have a question - there are some consistent > inconsistencies in the style of the output; for example, there is > 'purpose:' and 'usage:', but 'Example:' is capitalised. Is there some > compelling reason for this wrongness which people have passionate > opinions about, or can I fix it (i.e. "Usage:", etc.)? > > > -- > Nick Veitch > [email protected] > > -- > Juju-dev mailing list > [email protected] > Modify settings or unsubscribe at: > https://lists.ubuntu.com/mailman/listinfo/juju-dev > -- ** Frank Mueller <[email protected]> ** Software Engineer - Juju Development ** Canonical
-- Juju-dev mailing list [email protected] Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
