Guidelines and Procedures for Project Management

1 Guidelines and Procedures for Project ManagementCoin-ORFoundationMay 17, 2007 Contents1 Introduction32 Responsibilities33 Contacts and Information44 Definitions45 Establishing a New Scope of Contributions .. Legal Documentation .. Project Classification .. Dependence on Third-Party Software .. 96 Contribution to an Existing Trivial Contribution to an Existing Project .. Significant Contribution to an Existing Project .. Substantial Contribution to an Existing Project .. Contribution of a New Subproject to an Umbrella Project .. 107 Project The Project Manager.

2 Regular Project .. Umbrella Projects .. 111 Coin-ORFoundationContribution Guidelines and Project Maintenance .. Tracking Project Submissions and Authors .. Code and Documentation .. Project Mailing Lists .. Project Web Page .. Bug Reporting Channels .. Periodic Review .. 15A Contributor s Statement ofRespect for Ownership16B Documentation of ownership andLicensing for New Projects17C Contribution Check List For New Projects182 May 17, 2007 Coin-ORFoundationContribution Guidelines and Process1 IntroductionTheCoin-ORFoundation repository consists of a variety of independently managed open-source projects of potential interest to practitioners of operations research, including stu-dents, researchers, and professionals.

3 In order to ensure that the repository consists ofhigh-quality projects that are actively and effectively managed and to minimize theCoin-ORFoundation s legal exposure, these Guidelines and Procedures for Project managementhave been established by the TLC in accordance with the Repository Management Policyestablished by the SLB. Most of the Foundation s legal exposure comes from the fact that ourmission is to publicly disseminate intellectual property (IP). A guiding principle for projectmanagers is to ensure that the origin and ownership of all significant IP associated with aproject should be established before being offered for distribution (or redistribution).

4 Thisdocument, along with the accompanying Foundation policy document, provides a minimalset of Guidelines to ensure that the Foundation is in compliance with IP law and that qualitystandards are upheld. Project managers are encouraged to establish their own policies andprocedures to maintain high quality standards for their of this 2 lists individuals responsible for implementingthese Procedures . Section 3 lists useful contact information for easy reference. Section 4introduces the Project classification scheme and other attributes associated with 5 describes the Procedures for contributing new projects toCoin-OR.

5 Section 6describes the Procedures for contribution to an existing Project . Procedures for ongoingmaintenance of projects are described in Section 7. Required forms appear in Appendices Aand B. A checklist for new Project submissions appears in Appendix to this of this document is the responsibility of Members may suggest revisions or additions at any time. Sug-gestions should be sent to the chair of the TLC. The chair will assign a member of the TLCto evaluate the suggestion. The assigned TLC member will produce a recommendation foraction or no action on the suggestion, along with a justification.

6 Both the recommendationand the justification must be approved by a simple majority of the membership of the decision of the TLC is final. Suggestions may be resubmitted, but resubmissions mustsubstantially refer to the TLC s response to all related ResponsibilitiesAccording the Repository Management Policy of theCoin-ORFoundation, responsibilityfor maintaining the quality and integrity of theCoin-ORFoundation repository is theoverall responsibility of the TLC. These Procedures contain the implementation of thatpolicy, as interpreted by the TLC. Responsibility for implementing these Procedures andensuring that they are followed falls on two individuals appointed by the TLC for indefinite3 May 17, 2007 Coin-ORFoundationContribution Guidelines and Processterms.

7 Thesubmission manageris responsible for determining the acceptability of newprojects submitted as candidates for acceptance into the repository. Therepository manageris responsible for ensuring that existing projects adhere to the standards described hereinand are classified appropriately. He is also responsible for controlling access to the Project managers are responsible for maintaining their own projects and for beingresponsive to any requests from the repository manager or the TLC. A guiding principle ofthese Procedures , however, is to avoid placing unnecessary requirements on Project managerswhile encouraging best practices by rewarding exemplary Project Management with increasedstatus conferred through the Project classification scheme (see Section 4).

8 3 Contacts and InformationThis section lists the email addresses and web page URLs that are mentioned in the remainderof this document or that might be helpful for getting additional contacts:Repository coordinatorvaries with pages:Coin- DefinitionsAprojectconsists generally of a collection of related digital files with a common of projects include collections of source code for building executable software,collections of data files comprising instances of operations research problems, tutorials, anddocumentation, among are divided into two classes according to the level of development activityand available support.

9 Anactiveproject is a Project actively maintained with publiclyaccessible channels for reporting bugs or suggesting improvements. Anarchivedprojectis a Project without such channels and made available as is. An archived Project mightconsist of legacy software that does not build but is deemed interesting for historical , it might be a previously active Project that is no longer maintained. It couldalso be software submitted to the repository by someone who is not interested in actively4 May 17, 2007 Coin-ORFoundationContribution Guidelines and Processmaintaining are also classified as eitherregularorumbrella projects.

10 An umbrellaproject consists of a collection of related subprojects. Examples are the Cut Generator Li-brary (CGL) Project or the Open Solver Interface (OSI) Project . Active umbrella projectshave one or more overall Project manager(s), as well as subproject managers for each sub- Project . Any Project that is not an umbrella Project is containing source code are divided into five levels reflecting the status of the devel-opment of the Project : Level 1: Projects that are not yet functional, that cannot be built without specialtools, or that otherwise do not meet the standard for a Level 2 Project .