Juju Docs now live!
Antonio Rosales
antonio.rosales at canonical.com
Fri Jun 28 19:12:00 UTC 2013
Nick/Marco/Jorge and all who worked on the docs,
Thanks for your work on the docs! I think we are well on our way
to achieving the goal of having docs be correct, current, user-friendly,
and engaging.
Gustavo,
Thanks for the taking a look at the docs and giving us feedback. I have
filed bug https://bugs.launchpad.net/juju-core/+bug/1195834 as task for us
to follow up on. As a charmers group we'll sync up on Monday and see how
fast we can ensure all old content can be moved forward. This was an
initial goal, but seems we may have missed some content. If we cannot get
all old content ported forward by next week we'll revert back. The
redirects should also land on Monday.
Feedback is very welcome so keep it coming. Its one of the ways we are
going to make the docs superb!
-Thanks,
Antonio
On Fri, Jun 28, 2013 at 12:40 PM, Gustavo Niemeyer <
gustavo.niemeyer at canonical.com> wrote:
> Hi Nick,
>
> On Thu, Jun 27, 2013 at 9:11 PM, Nick Veitch <nick.veitch at canonical.com>
> wrote:
> > Dear everybody,
> > The new docs for Juju are now live at https://juju.ubuntu.com/docs/ !
>
> Thanks for pushing that work. It looks much better in many senses.
>
> With that said, I'm very concerned that a lot of important
> documentation seems to be missing from the new version.
>
> For example, the writing a charm document is extremely lightweight,
> and has broken formatting as well:
>
> https://juju.ubuntu.com/docs/authors-charm-writing.html
>
> Compare that with:
>
> http://jujucharms.com/docs/charm.html
>
> This is a *significant* step backwards, and leaves people with no
> information for writing charms.
>
> In addition, external online resources now point to 404s. For example:
>
>
> http://askubuntu.com/questions/82683/what-juju-charm-hooks-are-available-and-what-does-each-one-do
>
> I strongly suggest reverting to the old documentation until these
> issues are fixed.
>
>
> gustavo @ http://niemeyer.net
>
> --
> 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/20130628/90a18258/attachment.html>
More information about the Juju
mailing list