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

Anne Gentle anne at openstack.org
Fri Jan 9 13:59:46 UTC 2015


Oh hi list!

Feel free to discuss the "a project just getting started" content that ends
up on the wiki -- where would that go?

Anne

On Thu, Jan 8, 2015 at 9:51 PM, Anne Gentle <anne at openstack.org> wrote:

> 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.
> Anne
>
> On Thu, Jan 8, 2015 at 12:31 PM, Stefano Maffulli <stefano at openstack.org>
> wrote:
>
>> 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/20150109/e7175da8/attachment.html>


More information about the OpenStack-dev mailing list