Great to have you here. Here are a few ways you can help make this project better!
You are encouraged to use the following mailing list to ask anything before contributing code:
http://groups.google.com/group/agendav-dev
Perhaps something is already implemented or some code is going to be completely wiped, so a patch for it is not worth the effort. Feel free to subscribe, it is a really low traffic list. Don't be afraid to ask!
There are some facts that will help you when contributing code to AgenDAV:
- AgenDAV ships with a Vagrant environment that is absolutely recommended when developing
- AgenDAV repository uses nvie's git flow
- Please, ask on
agendav-devlist (see above) before sending a new PR - Pull requests should only affect the
developbranch. PRs that affect themasterbranch will be discarded. If you think your PR could also be useful for latest stable (masterbranch) just comment it on the PR description - AgenDAV code follows PSR-1 and PSR-2
- Make your pull requests as small as possible. One pull request, one feature
- Make sure to add tests for your feature, and update the documentation if needed
When reporting a bug make sure you specify the following data:
- Your AgenDAV version
- What CalDAV server you are using
- A brief description of the issue
- Step by step guide of what you did. Screenshots are welcome
- What you were expecting to happen and what actualy happened
- Any logs that could help
It would be great if you could also try to reproduce the bug on latest HEAD.
AgenDAV uses Transifex for translations.
Have a look at Transifex documentation for more information about adding a new language or upadting an existing translation.
Documentation is automatically generated and placed on http://docs.agendav.org/ . Updating the documentation requires some Sphinx knowledge.
Have a look at the doc/ directory.