JBoss Development Process Guide 2004, Ivelin Ivanov, Ryan Campbell, Pushkala Iyer, Clebert Suconic, Mark Little, Andrig Miller, Alex Pinkin Table of Contents Preface ................................................................................................................................................ vii 1. Overview ...........................................................................................................................................1 1.1. Background .............................................................................................................................1 1.2. JEMS integration milestones .....................................................................................................2 2. Productizing Steps in the Overall Release Process .................................................................................4 2.1. I. Background ..........................................................................................................................6 2.2. II. Turning a Project into a Product ............................................................................................6 2.2.1. I. Product Road Map Creation and Maintenance ............................................................10 2.2.1.1. Questions for Constructing the Road Map ..........................................................11 2.2.1.2. Project road map checklist: ................................................................................12 2.2.2. II. Reference Documentation ........................................................................................12 2.2.2.1. Project reference documentation checklist: .........................................................13 2.2.3. III. On-line Education ..................................................................................................14 2.2.3.1. Project on-line education checklist: ....................................................................14 2.2.4. IV. Training Materials .................................................................................................15 2.2.4.1. Training materials checklist: ..............................................................................15 2.2.5. ...................................................................................................................................16 2.2.6. V. Quality Assurance ...................................................................................................17 2.2.6.1. Quality assurance checklist: ...............................................................................17 2.2.7. VI. Development and Management Tooling ..................................................................19 2.2.7.1. Development tooling checklist: ..........................................................................20 2.2.8. VII. Release the stable or final release ...........................................................................20 2.2.8.1. Release checklist: .............................................................................................21 2.3. Appendix A. ..........................................................................................................................22 2.3.1. Key Contacts for the Productizing Process ....................................................................22 3. JBoss Issue Tracking .........................................................................................................................24 3.1. Creating a new Project ............................................................................................................24 3.2. Creating Release Notes ...........................................................................................................24 3.2.1. Adding Issues to Release Notes ....................................................................................24 3.2.2. Generating Release Notes ............................................................................................25 3.3. Issues ....................................................................................................................................25 3.3.1. Types .........................................................................................................................25 3.3.2. Priorities .....................................................................................................................25 3.3.3. Estimates and Due Dates ..............................................................................................26 3.3.4. Affects Checkboxes .....................................................................................................26 3.4. Managing Container Projects ..................................................................................................26 3.5. Project Source Repository and Builds ......................................................................................27 3.6. Testsuites ...............................................................................................................................27 3.7. Dependency Tracking with JIRA .............................................................................................27 4. Build Reference ................................................................................................................................28 4.1. Overview and Concepts ..........................................................................................................28 4.2. Component Build ...................................................................................................................28 4.2.1. Component Info Elements Reference ............................................................................28 4.2.2. Component Definition Elements Reference ...................................................................29 JBoss 2004, Ivelin Ivanov, Ryan ii JBoss Development Process Guide 4.2.2.1. .........................................................................................................................29 4.3. How to Synchronize and Build ................................................................................................30 4.4. Tutorial: Anatomy of a Component Build ................................................................................30 4.4.1. Top Level Build ..........................................................................................................30 4.4.2. Component Level Build ...............................................................................................32 4.4.2.1. Defining an Artifact ..........................................................................................36 4.4.3. Placing an Artifact in the Release .................................................................................37 4.5. How to Add a Component to the Repository ............................................................................37 5. CVS Access for JBoss Sources ..........................................................................................................40 5.1. Understanding CVS ................................................................................................................40 5.2. Obtaining a CVS Client ..........................................................................................................40 5.3. Anonymous CVS Access ........................................................................................................40 5.4. Committer Access to CVS and JIRA .......................................................................................42 6. CVS Administration ..........................................................................................................................44 6.1. Creating and Managing Release Branches ................................................................................44 6.1.1. Release Numbering .....................................................................................................44 6.1.2. Example Release Scenarious ........................................................................................45 6.2. Creating a New Binary Release Branch ...................................................................................46 6.3. Checking Code into the MAIN Trunk ......................................................................................47 6.4. Checking in a Patch on a Release Branch .................................................................................48 6.5. Checking in a Patch on a Non-JBoss CVS Module Release Branch ...........................................49 7. SVN Access for JBoss Sources ..........................................................................................................51 7.1. Understanding SVN ...............................................................................................................51 7.2. Obtaining an SVN Client ........................................................................................................51 7.3. Anonymous CVS Access ........................................................................................................51 7.4. Committer Access to SVN and JIRA .......................................................................................52 8. SVN Administration .........................................................................................................................53 8.1. Creating and Managing Release Branches ................................................................................53