Difference between revisions of "Releasing Contribs"

From SME Server
Jump to navigationJump to search
(improved the link to point to the section about developing contribs)
(Added some extra information and did some rearanging)
Line 19: Line 19:
 
The SME Extras repository will contain RPMs that have been through a review process, RPMs in the SME Extras repository will be able to be installed directly from the Software Installer panel in the server-manager. Currently the SME Extras repository does not hold any contribs, but this will change in the future.  
 
The SME Extras repository will contain RPMs that have been through a review process, RPMs in the SME Extras repository will be able to be installed directly from the Software Installer panel in the server-manager. Currently the SME Extras repository does not hold any contribs, but this will change in the future.  
  
====Submission process====
+
{{Note box|The process for having your contrib included in SME Extras is currently being outlined and developed and therefore is far from complete.}}
{{FixMe}}
+
===Sumitting a contrib to the SME Server repository===
*Note, The process for having your contrib included in SME Extras is currently being outlined and developed and therefore is far from complete.
 
 
 
 
To get your package in the SME Extras repository it has to go through a review process. The first steps to get your contrib in the SME Extras repository are:
 
To get your package in the SME Extras repository it has to go through a review process. The first steps to get your contrib in the SME Extras repository are:
  
Line 29: Line 27:
 
* (a link to) the source RPM (SRPM)
 
* (a link to) the source RPM (SRPM)
 
    
 
    
2. SME Server code is stored in the CVS on [http://www.sourceforge.net SourceForge].  
+
2. SME Server code is stored in the CVS on [http://www.sourceforge.net SourceForge]. To be able to work on your code in the SME Server CVS repository you need an account on SourceForge. With this account the development team can give you access to the CVS repository. More information can be found here:
* To be able to work on your code in the SME Server CVS repository you need an account on SourceForge. With this account the development team can give you access to the CVS repository. More information can be found here:
 
 
*  [http://sourceforge.net/docman/display_doc.php?docid=11123&group_id=1 B04: Registering a User Account]
 
*  [http://sourceforge.net/docman/display_doc.php?docid=11123&group_id=1 B04: Registering a User Account]
 
*  [http://sourceforge.net/docman/display_doc.php?docid=29894&group_id=1 E04: CVS (Version Control for Source Code)]
 
*  [http://sourceforge.net/docman/display_doc.php?docid=29894&group_id=1 E04: CVS (Version Control for Source Code)]
Line 38: Line 35:
 
4. After the development team has added you to the [http://sourceforge.net/project/memberlist.php?group_id=96750 list of developers] you can create a SSH key which is necessary to get access to the SME Server CVS, more on this can be found here: [http://sourceforge.net/docs/F02/en/#top F02: SSH Key Generation and Usage]
 
4. After the development team has added you to the [http://sourceforge.net/project/memberlist.php?group_id=96750 list of developers] you can create a SSH key which is necessary to get access to the SME Server CVS, more on this can be found here: [http://sourceforge.net/docs/F02/en/#top F02: SSH Key Generation and Usage]
  
5. After you have received developer access you will have to download and configure your CVS client to work with the SME Server CVS. More information can be found here: [http://sourceforge.net/docman/display_doc.php?docid=14026&group_id=1 B01: Recommended User Software Configuration (en) ]
+
5. After you have received developer access you will have to download and configure your CVS client to work with the SME Server CVS. More information can be found here: [http://sourceforge.net/docman/display_doc.php?docid=14026&group_id=1 B01: Recommended User Software Configuration (en) ]. The SME Server development team has decided on using [[Mezzanine]] (see next item).
 +
 
 +
6. Install [[Mezzanine]] and read up on how to use it in the [http://mirror.contribs.org/smeserver/contribs/gordonr/devguide/html/c1577.htm SME Server's Developers Guide - The SME Server development environment].
 +
 
 +
7. Subscribe yourself to the [http://lists.contribs.org/mailman/listinfo/devinfo devinfo mailinglist]. This is the place to discuss the developement of the server and contribs. If you have other questions, not regarding development please use the [http://forums.contribs.org forums].
 +
 
 +
===Having your contrib reviewed===
 +
{{Incomplete}}
 +
The review process has not been outlined.
  
 
<noinclude>[[Category:Howto]]</noinclude>
 
<noinclude>[[Category:Howto]]</noinclude>

Revision as of 13:00, 17 June 2007

Releasing Contribs

Writing

The Developers Manual has information required to write a contrib for SME Server

Releasing

For consistency between contribs it's suggested that you follow these guidelines

1. Announce your new rpm on the Contribs forum, make the subject similar to below [ANNOUNCE] rpm name

2. Submit a bug to the Bug Tracker, for SME Contribs, asking for a new component to be added with your rpm name. Include links to download your rpm including your src rpm. Include a short description, perhaps the description from the spec file

Your contrib should preferably be in the SME Dev repository, see below for how to obtain access.


Important.png Note:
If your contrib is not in SME Dev or has no category in the SME Server Bugtracker please do so.


SME Extras Repositories

The SME Extras repository will contain RPMs that have been through a review process, RPMs in the SME Extras repository will be able to be installed directly from the Software Installer panel in the server-manager. Currently the SME Extras repository does not hold any contribs, but this will change in the future.


Important.png Note:
The process for having your contrib included in SME Extras is currently being outlined and developed and therefore is far from complete.


Sumitting a contrib to the SME Server repository

To get your package in the SME Extras repository it has to go through a review process. The first steps to get your contrib in the SME Extras repository are:

1. Submit your contrib for Package Review in the SME Server Extras category of the Bugtracker. Be sure to add the following information:

  • (a link to) the SPEC file
  • (a link to) the source RPM (SRPM)

2. SME Server code is stored in the CVS on SourceForge. To be able to work on your code in the SME Server CVS repository you need an account on SourceForge. With this account the development team can give you access to the CVS repository. More information can be found here:

3. After you have created your SourceForge account you can ask the development team to give you developer access. Create a bug in the Bug Tracker as usual.

4. After the development team has added you to the list of developers you can create a SSH key which is necessary to get access to the SME Server CVS, more on this can be found here: F02: SSH Key Generation and Usage

5. After you have received developer access you will have to download and configure your CVS client to work with the SME Server CVS. More information can be found here: B01: Recommended User Software Configuration (en) . The SME Server development team has decided on using Mezzanine (see next item).

6. Install Mezzanine and read up on how to use it in the SME Server's Developers Guide - The SME Server development environment.

7. Subscribe yourself to the devinfo mailinglist. This is the place to discuss the developement of the server and contribs. If you have other questions, not regarding development please use the forums.

Having your contrib reviewed

Incomplete.png Incomplete:
This article or section needs to be expanded. Please help to fill the gaps or discuss the issue on the talk page


The review process has not been outlined.