Juju Docs now live!

[Antonio Rosales]

On Mon, Jul 1, 2013 at 11:07 AM, Henning Eggers <henning at keeeb.com> wrote:

> Hi Nick!
>
> Thanks for fixing the documentation, in general as well as in this
> particular
> instance. Working my way in to juju at the moment, I very much appreciate
> good
> documentation.
>
Great to hear you are using Juju. :-)


>
> On 01.07.2013 16:24, Gustavo Niemeyer wrote:
> > On Mon, Jul 1, 2013 at 11:06 AM, Nick Veitch <nick.veitch at canonical.com>
> wrote:
> >> I am sure there are other bits that are needed, or have been left
> behind. If
> >> I have missed something, please let me know. That is how we fix things.
> > That doesn't sound like a good plan. This wasn't a minor detail
> > missing, but a relevant volume of information just going away, and the
> > new content being badly formatted.
>
> I have to agree with Gustavo that this error was quite big, at least for
> me. I
> was dumbfounded on Friday when I returned to the docs and could not find
> important information. These were the only references to hook names and
> hook
> utilities and vital when writing a charm.
>
> Having the same data (old -> new)  is paramount. As a result Nick has
fixed LP bug https://bugs.launchpad.net/juju-core/+bug/1195834 and our
infrasturcture team has updated the docs bein served out. You should see
all the content live at juju.ubuntu.com/docs now. Apologies for
the confusion on Friday. :-/


> That said ...
>
> >> We most definitely do not want to revert to old docs from which people
> can't
> >> even install and configure juju properly!
> > I'm sure the previous documentation wasn't great, after all we indeed
> > appreciate your help improving that content. That said, silently
> > taking critical information away is much worse.
> >
>
> ... I am not sure that is true, either. Before, with the old docs, I was
> having a hard time trying out juju for the first time and it took me
> several
> attempts to get it working. So, if the new documentation fixes this
> first-time
> experience, I agree that that is more important. As long as glitches like
> the
> current one get fixed as quickly as it did now.
>

Our main target is to make the docs correct and user-friendly. For folks
interested where we have been collaborating on this we are working out of
blueprint:
https://blueprints.launchpad.net/ubuntu/+spec/servercloud-s-juju-docs.

Any feedback is much appreciated, and if any other issue are found please
feel free to open a bug or ping in #juju. We believe at this time for the
docs to have all the old content (less drafts). However, if
you notice something missing or have feedback we definitely want to hear
about it.

-Thanks,
Antonio



>
> Cheers,
> Henning
>
>
> --
> Juju mailing list
> Juju at lists.ubuntu.com
> Modify settings or unsubscribe at:
> https://lists.ubuntu.com/mailman/listinfo/juju
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/juju/attachments/20130701/7aaa68b8/attachment.html>