doc/source/contribute.rst

   1 Contributing
   2 =============
   3
   4 Use git, `learn if needed`_.
   5
   6 Git Workflow
   7 -------------
   8 * ``master`` branch holds latest stable|release code
   9 * ``dev`` branch holds current development code
  10 * Work on a dedicated branch starting off ``dev``
  11 * I like fast forward merges, **please rebase on** ``dev`` **branch**
  12 * Advertise your work (cf. Note)
  13
  14 .. NOTE::
  15     **Git merge Workflow** |br|
  16     I currently don't care about a specific workflow concerning changes submission. |br|
  17     gitlab merge request, gh pull request, plain email pointing out a repo/ref. All we need is a public git repo and a ref to fetch from as long you rebased on ``dev`` branch.
  18
  19 Coding
  20 -------
  21
  22 * follow pep8
  23 * write unittest
  24 * actually test your code (unit and functional testing)
  25
  26
  27 .. _`learn if needed`: https://git-scm.com/book/
  28
  29 .. |br| raw:: html
  30
  31     <br />
  32
  33 .. vim: spell spelllang=en