Gentoo Wiki:Developer Central/Project pages

Creating a new project page
First of all, you need to decide on a URL name for your project. Keep it as simple as possible: For instance, if you are the 'Gentoo Fnord Project', call it 'Fnord'. Note the first letter will always be uppercased by the Wiki software.  http://wiki.gentoo.org/Project:Fnord  will be the project space of the Fnord Project with Project:Fnord as its main page.

You can add more documents to your project space. For instance you could have your project policies available under  http://wiki.gentoo.org/Project:Fnord/Project policy . This makes the page 'Project policy' a subpage of your project space.

Your subpages should all contain a category (the main page is automatically added). Either, use Category:Projects, or create a new one for your project (Category:Project:Fnord in our example). Should you create your own category, it should contain Category:Projects as its parent. To add a category to a page or another category, put a link at the end of the contents: Adding a category

Now you're ready to create your project's main page:

Migration from www.gentoo.org/proj/
To migrate your project page from www.gentoo.org to the Wiki, create a project page as outlined above.

Then, look through the contents of your project directory in CVS and choose what to do with the documents:
 * Keep them, and move as-is to the Wiki
 * Use the automatically converted versions (see below) as a starting point for the new page inside your Wiki project space.


 * Keep them, move to the Wiki and allow users to improve documents
 * As above, but create the page in the main namespace (i.e. no Project:Fnord</tt> in front). Do check for existing documentation on the topic.


 * Discard
 * Delete the file in CVS.

Automatically converted documents
To help migrating contents, we provide automatically converted versions of GuideXML documents.

These are available at:  http://dev.gentoo.org/~swift/tmp/proj2wiki/ </tt>. For example, if the old URL was http://www.gentoo.org/proj/en/infrastructure/index.xml, the converted version is available at http://dev.gentoo.org/~swift/tmp/proj2wiki/infrastructure/index.xml.

Redirecting
After migrating the documents, you should redirect the old pages to wiki.gentoo.org. In the GuideXML documents, edit the main XML tags guide</tt> or project</tt>:

Redirecting contents

Redirecting main project page

Finished migrating?
If you have finished migrating, i.e. all documents either redirect or are deleted, please go to the Project Page Migration Status page and edit the table noting that your project is done.

FAQ

 * A developer is not listed to be added as a member. / I added a developer in the source and it only shows garbage.
 * The developer in question did not properly set up his account on the Wiki. Direct them to the user setup documentation. After successful completion of the account setup, the developer can be selected. If you used the source, stop doing that.


 * I just added a subproject, but the project page doesn't list it. / On my user page, a newly added project doesn't show up.
 * The subprojects list is cached. To clear the cache, go to the upper right menu, next to 'Edit' there is a dropdown menu (with a downwards arrow), in there select 'Refresh'.


 * Where do I put additional files?
 * You can upload media files to the Wiki, where they will be editable by all users. Everything else as well as files you do not want to risk being edited should remain on www.gentoo.org for the time being. A replacement hosting arrangement will be posted in due time.


 * Who can edit the project pages?
 * Everything in the Project:</tt> namespace is only editable by Gentoo developers who have completed the account setup.


 * I want to let certain users edit pages.
 * This feature will be available in the future. To gauge interest, please let the Wiki Team know you request this feature.


 * How do I create subprojects?
 * Just like a regular project, but select your project as parent, not Project:Gentoo</tt>. Features such as inheritmembers from GuideXML project pages are not currently supported.