Can you guys please update and properly link the setup docs, then? I spent
twenty minutes looking for them (on rtd, mdn, the git wiki, etc). I'd like
to start contributing but I couldn't even find the setup instructions (for
the project that holds documentation, ironically) and I'm a Mozilla
employee!
On May 13, 2013 9:33 AM, "Les Orchard" <notifications@github.com> wrote:

> In README.rst:
>
> > @@ -13,3 +13,11 @@ It is a Django_ application.
> >
> >
> >  You can access the staging site at https://developer.allizom.org/
> > +
> > +-------
> > + Setup
> > +-------
> > +
> > +Installation instructions can be found at:
> > +
> > +https://github.com/mozilla/kuma/blob/master/docs/installation.rst
>
> I'd bet those instructions are way out of date and no longer work. But,
> I'd rather leave "regular" installation (ie. manual) as an advanced
> exercise. (It's not regular, because we've never really had it working that
> way :) )
>
> Although we've left MindTouch behind, we've still got a lot of moving
> parts beyond Django (eg. celery, rabbit, kumascript, elasticsearch, etc).
> Vagrant + puppet handles those, they're handy to have available. Of course
> those additional services can be disabled / stubbed out, but we haven't
> done much work toward that.
>
> Still, I'd hate to try maintaining both the puppet manifests and a plain
> english explanation on how to install by hand.
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/mozilla/kuma/pull/1081/files#r4196877>
> .
>