Juju 1.x had a ton of help in the CLI, right at your fingertips: $ juju1 help topics azure-provider How to configure a Windows Azure provider basics Basic commands commands Basic help for all commands constraints How to use commands with constraints ec2-provider How to configure an Amazon EC2 provider global-options Options common to all commands glossary Glossary of terms hpcloud-provider How to configure an HP Cloud provider juju What is Juju? juju-systems About Juju Environment Systems (JES) local-provider How to configure a local (LXC) provider logging How Juju handles logging maas-provider How to configure a MAAS provider openstack-provider How to configure an OpenStack provider placement How to use placement directives plugins Show Juju plugins spaces How to configure more complex networks using spaces topics Topic list users About users in Juju
Almost all of this has been removed in 2.0: $ juju help topics basics Basic Help Summary commands Basic help for all commands global-options Options common to all commands topics Topic list There are a lot of parts of the CLI that *need* that extra level of documentation. I'm all for dropping a link to the website at the bottom of some help docs for further info, but dropping the help entirely seems like a mistake. Some things like constraints and placement are used in multiple commands, but there's no way to know from the CLI how to entire valid values for them. Things like the providers are not explained anywhere in the CLI now, as far as I can tell. The plaintext docs are the easiest thing for us to update and maintain... they live right in our own repo and let us update them whenever the code updates, and they're the easiest thing for users to get to... let's not drop that on the floor. -Nate
-- Juju-dev mailing list [email protected] Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
