I'd appreciate some input on below plan to move project pages to the Wiki:

Motivation
----------

The main motivation is to reduce the contents on the main website,
allowing for an easier makeover. Also, the Wiki exposes the contents and
an editing capability to more people, allowing for better collaboration.
Finally, this is an opportunity for projects to go through the contents
in their project spaces and update/remove outdated contents as well
Gentoo as a whole to remove orphaned projects.

Process
-------

- Infra: /proj/* in CVS becomes read-only
- Projects: Go through documents, updating them or marking them to be
  discarded
- Projects: Use a GuideXML-to-Wikisyntax conversion tool to create an
  initial wiki version of the document
- Projects: Enter URL mapping information into a form
- Infra: Redirect www.g.o/proj/* to the respective Wiki pages

Before doing this with every project, I'd like to do a field trial with
2-4 projects.

Timeframe
---------

The process should not take longer than 4 weeks.

Special pages and contents
--------------------------

herds.xml, repositories.xml, etc.:
As these are intended for other applications to use, these should go to
a new site, possibly api.gentoo.org, initially fed from a git repository.
This site should get backed by SSL.

Image resources:
These can be uploaded to the Wiki.

Other files and downloads:
Until proper project file hosting is implemented, again a simple
git-backed static site, possibly projects.gentoo.org.

Project main pages:
Using Semantic MediaWiki, we can represent all the semantic information
we had on the project pages, like members and subprojects, on the Wiki
as well.
(Do we need more information than we can currently express in the
guidexml markup or can any be removed?)

Project-created documentation:
Projects should consider moving documentation pages they created into
the main Wiki namespace, allowing users to improve the documents.

-- 
Alex Legler <a...@gentoo.org>
Gentoo Security/Ruby/Infrastructure

Attachment: signature.asc
Description: OpenPGP digital signature

Reply via email to