[openstack-dev] offlist: The scope of OpenStack wiki [all]

Anne Gentle anne at openstack.org
Fri Jan 9 03:51:25 UTC 2015

Hi Stef, thanks for writing this up. One aspect this proposal doesn't
address is the ungoverned content for projects that are either in
stackforge, pre-stackforge, incubating, or have no intention of any
governance but want to use the openstack wiki. What can we do if one of
those groups raises the issue? We can talk more about it tomorrow but it's
problematic. Not unsolvable but lack of governance is one reason to be on
the wiki.

On Thu, Jan 8, 2015 at 12:31 PM, Stefano Maffulli <stefano at openstack.org>

> hello folks,
> TL;DR Many wiki pages and categories are maintained elsewhere and to
> avoid confusion to newcomers we need to agree on a new scope for the
> wiki. A suggestion below is to limit its scope to content that doesn't
> need/want peer-review and is not hosted elsewhere (no duplication).
> The wiki served for many years the purpose of 'poor man CMS' when we
> didn't have an easy way to collaboratively create content. So the wiki
> ended up hosting pages like 'Getting started with OpenStack', demo
> videos, How to contribute, mission, to document our culture / shared
> understandings (4 opens, release cycle, use of blueprints, stable branch
> policy...), to maintain the list of Programs, meetings/teams, blueprints
> and specs, lots of random documentation and more.
> Lots of the content originally placed on the wiki was there because
> there was no better place. Now that we have more mature content and
> processes, these are finding their way out of the wiki like:
>       * http://governance.openstack.org
>       * http://specs.openstack.org
>       * http://docs.openstack.org/infra/manual/
> Also, the Introduction to OpenStack is maintained on
> www.openstack.org/software/ together with introductory videos and other
> basic material. A redesign of openstack.org/community and the new portal
> groups.openstack.org are making even more wiki pages obsolete.
> This makes the wiki very confusing to newcomers and more likely to host
> conflicting information.
> I would propose to restrict the scope of the wiki to things that
> anything that don't need or want to be peer-reviewed. Things like:
>   * agendas for meetings, sprints, etc
>   * list of etherpads for summits
>   * quick prototypes of new programs (mentors, upstream training) before
> they find a stable home (which can still be the wiki)
> Also, documentation for contributors and users should not be on the
> wiki, but on docs.openstack.org (where it can be found more easily).
> If nobody objects, I'll start by proposing a new home page design and
> start tagging content that may be moved elsewhere.
> /stef
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150108/c1d26c97/attachment.html>

More information about the OpenStack-dev mailing list