Contributing to Limnoria as a developer¶
Note
This page is still a draft and is not complete.
About the policy about repository access¶
For the moment, I decided to give write access to my repository to nobody, because I want to check everything that is pushed in it. If someone pushes a bad update, it may be dangerous for users and I do not want that.
On the other side, I am very open to pull requests, that’s to say, if you ask me to merge some changes you made, there are 99% changes I will merge this changes. That’s why I suggest you to fork my repository on GitHub, make your modifications, and click the “Pull requests” button in my repository.
Using Git¶
If you are a developer, I assume that you know how to use Git. If you don’t, I suggest you to learn how to use it, at least the basics (clone, checkout, branch, commit, push/pull, add/rm, log, show, reset, revert).
I learnt how to use Git with an ebook, also available as a real book: Pro Git.
Our preferred way of contributing is through GitHub pull requests to Limnoria’s repository. Please send your pull requests to the testing branch.
Where to start¶
If you are not an experienced Python and/or Limnoria developer, you can start with solving issues tagged as easy. I believe they are likely to be easy to solve even without a lot of experience.
If you need help solving an issue (tagged as easy or not) or want to find an issue that matches your skills, please ask on IRC, we will be glad to help you.
Code style¶
Read the doc in the source code (docs/STYLE.rst).