[openstack-dev] Wiki

Matt Kassawara mkassawara at gmail.com
Wed May 11 15:39:36 UTC 2016


>From the perspective of contributing documentation and providing support
(mostly in #openstack) to a variety of consumers, the wiki tends to provide
yet another location for varying levels of content without a specific
audience and questionable relevance due to lack of maintenance. I find a
surprisingly large number of people referencing old content (OpenStack
sites and external sites such as personal blogs) because they don't
understand our release names or cycle length and the content doesn't always
make it clear. For documentation on OpenStack sites in particular, Google
doesn't help by ranking old content fairly high. I suspect that confusion
around preferred location of content and chronic frustration around
contributing to the central documentation (let's fix it! [1]) caused
sporadic growth of content on the wiki. Replacing the wiki with a
combination of more formal documentation and blog posts makes sense
providing the blog posts contain obvious publication dates (or relevant
release cycle) and, if necessary, some sort of deprecation notice to guide
consumers toward newer, more relevant content. Also, if content in a blog
post becomes more formal documentation, reference it.

[1] http://lists.openstack.org/pipermail/openstack-dev/2016-May/094390.html

On Wed, May 11, 2016 at 8:44 AM, Thierry Carrez <thierry at openstack.org>
wrote:

> Thierry Carrez wrote:
>
>> [...]
>> I'll soon start a thread on that. Since that goes a lot beyond the dev
>> community, I'll post it to the openstack general list and post a pointer
>> to it here.
>>
>
> See
> http://lists.openstack.org/pipermail/openstack/2016-May/016154.html
>
>
> --
> Thierry Carrez (ttx)
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> 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/20160511/58a3894f/attachment.html>


More information about the OpenStack-dev mailing list