commands

[Frank Mueller]

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 <nick.veitch at canonical.com>
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
> nick.veitch at canonical.com
>
> --
> Juju-dev mailing list
> Juju-dev at lists.ubuntu.com
> Modify settings or unsubscribe at:
> https://lists.ubuntu.com/mailman/listinfo/juju-dev
>



-- 
** Frank Mueller <frank.mueller at canonical.com>
** Software Engineer - Juju Development
** Canonical
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/juju-dev/attachments/20150203/5d1df37b/attachment.html>