On Fri, 10 May 2019 at 09:27, Tim Mooney <[email protected]> wrote:
> > Our infrastructure was too long without attention. As a result,
> > confluence was compromised. Confluence runs on
> > w01.openindiana.everycity.co.uk, together with main site and
> > exim/mailman.
>
> Thanks for the info, and for the cleanup work. That's never a fun task.
>
> > Given that actually nobody has cared enough for this infrastructure server,
> > we suggest the following steps.
> > 1) Moving all valuable information from wiki to
> > https://docs.openindiana.org and http://github.com/OpenIndiana/oi-userland/
> > docs directory.
> >
> > 2) Preserve wiki for now just for development purposes.
> >
> > 3) Completely decommission wiki once migration to oi-docs is finished.
>
> Just so I understand, is the consensus that there's not much value in a
> wiki, or that this particular Confluence wiki is more work than it's
> worth?
We ditched confluence on illumos.org recently for similar reasons.
Confluence is just a lot of maintenance work, and will always require
people to keep on top of security updates. A documentation site like
we now have for illumos is a bit easier on the infrastructure folks as
it's just a static directory of files, and authentication for edits is
all through a system we have to have anyway to manage the other source
code. Our docs site is up at:
https://illumos.org/docs/
from source at:
https://github.com/illumos/docs/
The other thing it gives us is a better process for reviewing changes
to the documentation. The wiki was a bit wild west, and there was a
_lot_ of content that we just deleted as part of the transition. It's
better to have a smaller quantity of documentation that's definitely
good, rather than a sprawling mess of things which are old and thus
actively misleading. The wiki model seems to have lead us down the
latter path, so we're trying the docs site approach.
It seems like a good approach for OpenIndiana as well!
Cheers.
--
Joshua M. Clulow
Engineer @ Joyent
http://blog.sysmgr.org
_______________________________________________
openindiana-discuss mailing list
[email protected]
https://openindiana.org/mailman/listinfo/openindiana-discuss
