[Openstack] Wiki love for projects pages

Ying Chun Guo guoyingc at cn.ibm.com
Tue Jan 7 02:18:36 UTC 2014


I think, new comers may want to know how to contribute and how to join the
project/program from the wiki page.
I would suggest to add such guides clearly in the wiki page.

Best regards
Ying Chun Guo (Daisy)


Stefano Maffulli <stefano at openstack.org> wrote on 2014/01/07 07:55:33:

> Stefano Maffulli <stefano at openstack.org>
> 2014/01/07 07:55
>
> To
>
> "General, OpenStack" <openstack at lists.openstack.org>,
>
> cc
>
> Subject
>
> [Openstack] Wiki love for projects pages
>
> There are quite some differences between wiki pages for the projects and
> more often than not I and others end up having to hit the search button
> to find out small details about a project, like who's the current PTL or
> when the project has its meetings. Also, sometimes reporters land on a
> page hosted on our wiki and they assume that whatever is on the wiki is
> officially endorsed by OpenStack as a whole.
>
> To alleviate these issues, I think it would be good to make sure that
> all project pages standardize on showing a minimum amount of common
> details in an easy to read fashion. Something like the Infobox you see
> on many pages on Wikipedia.
>
> I scanned the wiki and tried to collect a minimum set of data already
> shown but not consistently.  For example, an infobox template would look
> something like:
>
> {{Infobox
>
> Full name = OpenStack Networking
> Code name = Neutron
> Source code =
> Bug tracker =
> Blueprints =
> RoadMap =
> Developer doc =
> Current PTL =
> Meetings =
> Status    =   Integrated | Incubation | Related
> FAQ = Link to Ask/tag=
>
> }}
>
> The rest of the page would have more information like:
>
>  * Objective
>    (like the programs pages, state what the intention of the project
is/not)
>
>  * Resources for developers
>    (anything useful, from links to etherpads, howtos, names of
> volunteers...)
>
>  * Subpages
>    (automatically built)
>
>  * Related projects and related pages
>    (automatically built list of pages in the same project/program
category)
>
> The (incomplete, I assume) list of pages that need this sort of
> standardization:
>
> https://etherpad.openstack.org/p/wiki-templatization
>
> Questions for you: are the details in that infobox enough? What to
> add/remove?
>
> Any other suggestion to improve the presentation for newcomers
> (developers, users, end users) of the pages above?
>
> Cheers,
> stef
>
>
> --
> Ask and answer questions on https://ask.openstack.org
>
> _______________________________________________
> Mailing list:
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack
> Post to     : openstack at lists.openstack.org
> Unsubscribe :
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack/attachments/20140107/d47afe85/attachment.html>


More information about the Openstack mailing list