Contributing to the Community
- 1. MONTREAL JUNE 30, JULY 1ST AND 2ND 2012 Contributing to the Community Pascal Robert WOCommunity Association
- 2. Why should I? • Community will die if no one contributes! • Putting the burden on only 2-3 guys is a disaster waiting to happen • We are NOT competitors!
- 3. What can I do? • Fix bugs in Wonder and WOLips • Add new stuff to Wonder • Documentation (JavaDoc and wiki) • Unit tests! • Clean up Wonder
- 4. Contributing to Wonder • Create your own fork of Wonder • Fork on GitHub is the preferred way • Fork from the integration branch! • Send pull requests or patches to Wonder • Do your pull requests on integration!
- 5. Contributing to Wonder • When creating frameworks for your needs, think about how you can separate it to make contributions to Wonder
- 6. Integration branch and releases • integration branch is where the new stuff is • Patches and pull requests are added to the integration branch • Commits added to integration are added to master 3-4 weeks after • When commits are added to master, tagged as a release
- 7. This is how to do it
- 8. Adding stuff to Wonder • Put it in the correct location (Examples or Frameworks) • Don't forget to add it to the Ant build file (Build/build/build.xml) • Wonder build system doesn't care about the classpath in the WOLips project • Don't forget: Wonder is BSD-like!
- 9. Ant build files <target name="ERJQueryMobile.all"> <antcall target="global.framework.${build.action}" > <param name="project.principal.class" value="er.jquerymobile.ERJQueryMobile" /> <param name="project.name" value="ERJQueryMobile" /> <param name="project.dir" value="Frameworks/Ajax/ERJQueryMobile" /> <param name="wo.external.root.bundles" value="${frameworks.wonder.core}/Ajax/ERAttachment" /> </antcall> </target> <target name="JqueryMobileExample.all"> <antcall target="global.application.${build.action}" > <param name="project.type" value="application" /> <param name="project.principal.class" value="er.jquerymobile.exampleapp.Application" /> <param name="project.name" value="JqueryMobileExample" /> <param name="project.dir" value="Examples/Ajax/JqueryMobileExample" /> <param name="wo.external.root.bundles" value="${frameworks.wonder.core}/ERJQueryMobile/ERMoviesLogic" /> </antcall> </target> <target name="common.frameworks.all" depends="..., ERJQueryMobile.all" /> <target name="common.examples.all" depends="..., JqueryMobileExample.all" />
- 10. Fixing issues • Check the issues list on GitHub for Wonder and WOLips!
- 11. Clean up • Clean up the compiler warnings: • http://jenkins.wocommunity.org/job/WonderIntegration/warnings • Clean up the open tasks: • http://jenkins.wocommunity.org/job/WonderIntegration/tasks
- 12. Unit tests! • Know how to make unit tests? Add unit tests to Wonder! • EOF unit tests would be really useful...
- 13. Contributing to WOLips • Same process as forking and updating Wonder • Building instructions are on the wiki • Ask people to try your contributions
- 14. Documentation • Needs a lot of cleanup (wiki and JavaDoc)! • An idea: take one of the Wonder packages and check the JavaDoc and wiki pages for the package, and validate the docs • Don't forget to document bindings!
- 15. Your own projects • Working on stuff that will be added to Wonder?
- 16. Jenkins • You have a framework that you want to contribute? We can build and distribute it on jenkins.wocommunity.org • Doesn't have to be a WOLips or Wonder project, as long it's an open source project for the community
- 17. WOWODC • I would be more than happy to have help! • Presenters always welcome!
- 18. Sponsorship
- 19. MONTREAL JUNE 30, JULY 1ST AND 2ND 2012 Q&A