Purpose

Style guidelines for creating a software project on http://plone.org/products.

Prerequisities

In addition to your plone.org account please have an alpha/beta/release candidate, or final release ready to go.

Summary

In order to use the software center you will need at least:

• A top level project folder - Created for you when you add a project.
  
• A releases folder that contains a release - Created for you when you add a project.
  
• A release folder that contains a downloadable file (or link to externally hosted file) - You create one or more of these.
  
• A downloadable file (or link to externally hosted file) - You create one or more of these.
  

Step by Step

1. Creating Projects.
1. Go to http://plone.org/products.
   
2. Click on the 'Add New Project' button.
   
3. Fill in the required fields.
   
4. If possible, please add a screenshot.
5. Click save.
   
6. You have just added a project!
2. Creating Releases.
   
1. Go to http://plone.org/products/<your_project>
   
2. Under 'Project Resources' click on 'Releases'.
   
3. Fill in the required fields.
4. If possible, please add a 'Release Manager', 'Release Manager Contact E-mail', and 'Repository branch'. The repository branch should point to a software release tag, e.g. http://svn.plone.org/svn/collective/<your_project>/tags/1.0.
5. Please do not change the version number. More specifically do not add things like "-alpha1" because a single 1.0 release folder is intended to hold alpha/beta/release candidate and final versions. Changing the version number may confuse people by producing a hard-to-remember URL (e.g. /products/<your_product>/releases/1.2-alpha3). Or worse, multiple release folders for a single 1.0 release (a future release of Plone Software Center may prevent this).
   
6. Once you have created a release, please do not remove or rename it ever.  If you do a buildout that depends on it will not work anymore.
   
3. Creating Downloads.
   
1. Go to http://plone.org/products/<your_project>/releases.
2. From the 'Add item' drop down menu select either 'Downloadable file' or 'Externally hosted file'.
3. In the 'File Description' field, please add a description like 'Product Package', 'Product Installer', or 'Product Bundle'. If you do not, the filename will be used. Optionally, include the release type, like alpha, beta, release candidate, or final, e.g. 'Product Package (Alpha 1)'.
   
4. Fill in the required fields, 'File', and 'Platform'.
   
5. When creating your archive please use 'tgz' instead of 'tar.gz', Plone Software Center currently mangles the latter (this will be fixed in a future release).
6. Once you have created a downloadable file or link to offsite download, please do not remove or rename it ever.  If you do, a buildout that depends on it will not work anymore.

Further information

For more information please contact the website team.