openobject contribute

Download Openobject contribute

Post on 02-Jul-2015

129 views

Category:

Technology

5 download

Embed Size (px)

DESCRIPTION

Openobject contribute

TRANSCRIPT

  • 1. Open Object Community Book Release 1.0Tiny SPRL2009-04-09

2. CONTENTSi 3. ii 4. Open Object Community Book, Release 1.0IIntroduction5IIOur Open Source Vision9IIISummary of resources13IVWorking in teams151171.1Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171.2Ofcial Commiters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171.3 2PeopleQuality Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 192.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192.2Expert Teams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192.3Translators team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192.4VTeamsCommunity Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19The Planets and announcements213What are the planets ?254Writing Guidelines27VIBazaar, the version control system295Installing Bazaar336Quick Summary357How to get the latest trunk source code378How to commit Your Work399Use Case Developpers41CONTENTS1 5. Open Object Community Book, Release 1.0VIIDeveloping modules4310 Introduction4511 Getting Sources4712 Coding Guidelines4912.1 Development Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4912.2 Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5112.3 User Interface Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5212.4 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5413 Module Recorder5714 Review quality59VIII61Distribute Modules15 Publishing modules6316 Manage translations65IX67Improving Translations17 Translating in launchpad6918 Translating your own module71X73Documentation Process19 Books7519.1 Building a Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7519.2 Author Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7520 People7720.1 Authors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7720.2 Authors from Tiny . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7721 Modules7922 Building the documentation812CONTENTS 6. Open Object Community Book, Release 1.0 23 FAQ83XI85How to translate the Open Object Documentation in your language24 Prerequisite8725 Understanding the directory structure8925.1 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8926 Creating the translation directory structure9127 Translation templates9328 Managing source changes9529 Building the documentation in your language9730 Status99XIIMonthly IRC Meeting10131 Introduction10532 Preparation of the Meeting10733 Organisation of the Meeting10934 The phases of the meeting11134.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 34.2 Presentations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 34.3 Discussion on topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 34.4 Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 34.5 Summary Post . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112CONTENTS3 7. Open Object Community Book, Release 1.0XIIIBug Tracker113XIVFeature Requests117XVCommunication35 Forums121 12335.1 Users - Forum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 35.2 Developers - Forum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 36 IRC12537 Mailing Lists12737.1 Users Mailing List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 37.2 Technical Mailing List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 37.3 Partners Mailing List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 38 Wiki12939 Blog131XVIRelease Cycle13340 Explanation of the Versions13541 Introduction13741.1 Timeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 42 Processes13942.1 Community Meeting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 42.2 Branching to new stable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 42.3 Release Candidates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 42.4 Stable Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 42.5 Creating Screen cast for OpenERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Index4141CONTENTS 8. Part IIntroduction5 9. Open Object Community Book, Release 1.0 Here you will found informations about the organisation of the community in OpenERP project. It include a description of the different tools used, the role of the differents actors, and the different process for improvement management.7 10. Open Object Community Book, Release 1.08 11. Part IIOur Open Source Vision9 12. Open Object Community Book, Release 1.0 As to build up the best enterprise management software ever developed, we need a perfect organisation between all Open ERPs actors. So that we can benet and leverage the contributions and feedbacks from the community, the market knowledge and creation from partners and the quality control and vision of an editor. We focus on creating a fully Open Source development methodology. This page summarize the different community efforts on the Open ERP and Open Object projects. For more information, check How to contribute.11 13. Open Object Community Book, Release 1.012 14. Part IIISummary of resources13 15. Part IVWorking in teams15 16. CHAPTERONEPEOPLE Who are the different actors in the community of OpenERP.1.1 Contributors Contributors are people who wants to help the project getting better, add functionnality and improve stability. Everyone can contribute on the project with his own knowledge by reporting bugs, purposing smart improvment and posting patch. The community team is available on launchpad: https://launchpad.net/~openerp-community Member of the quality and commiter team are automatically members of the community.1.2 Ofcial Commiters Ofcial commiters are people allowed to commit in the community repository. Those people are approved as commiters by the community once theyve done enought good patch and/or contributions in the project. Their allow to : Purpose and post their own patch on bugs report. Review patches from contributors, comments and / or improve them. Commit well done patch or contribution in the community repository. Write a news on the Planet OpenERP RSS The commiter team is available on launchpad: https://launchpad.net/~openerp-commiter1.3 Quality Team Quality team are people from Tiny sprl responsible for the quality of the Ofcial repository. They assume the stability and coherence of the Ofcial version by review the community patch and commit. Theyre in charge to merge the commit from Community repository to Ofcial repository. Extra_addons and Others repository are not part of their responsability. If a commit isnt good enough, they must remove it from Community repository and report it in the bug tracker. In other case, they will apply the purposed commit in the Ofcial version. Like this, everyone will stay aware about what is or isnt accepted.17 17. Open Object Community Book, Release 1.0 The quality team is available on launchpad: https://launchpad.net/~openerp18Chapter 1. People 18. CHAPTERTWOTEAMS 2.1 Introduction As to help developers and contributors to take the right decision when improving OpenERP, we set up experts teams for different management domains. Only people that have a strong experience in OpenERP and the related domain can apply as an expert. We have teams of accountants, manufacturing experts, technical experts, services management experts, ... Developers can contact our experts mailing list when they need feedback on particular features to be developed. Please contact our experts only for new developments related questions. They dont provide help on current features of OpenERP. Most of our experts have very high positions in the company they work for, so they dont have time to spent providing help or support.2.2 Expert Teams Accounting: https://launchpad.net/~openerp-expert-accounting/+members Services Management: https://launchpad.net/~openerp-expert-service/+members Manufacturing Industries: https://launchpad.net/~openerp-expert-production/+members2.2.1 Requesting Advices to A Team When you create a specication of a new feature on launchpad (called a blueprint), you can assign an expert team as a drafter of the specications. Then, you can click on request feedback on your blueprint and assign this to an expert team. They will receive a notication email and will discuss about the requested feature. The team will improve your specications directly in your blueprint.2.3 Translators team 2.4 Community Team19 19. Open Object Community Book, Release 1.020Chapter 2. Teams 20. Part VThe Planets and announcements21 21. Open Object Community Book, Release 1.0Contents The Planets and announcements What are the planets ? Writing Guidelines23 22. Open Object Community Book, Release 1.024 23. CHAPTERTHREEWHAT ARE THE PLANETS ? The