File: contribute.rst

package info (click to toggle)
python-musicpd 0.9.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 484 kB
  • sloc: python: 792; makefile: 6
file content (37 lines) | stat: -rw-r--r-- 988 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
.. SPDX-FileCopyrightText: 2018-2021  kaliko <kaliko@azylum.org>
.. SPDX-License-Identifier: LGPL-3.0-or-later

Contributing
=============

Use git, `learn if needed`_.

Git Workflow
-------------
* ``master`` branch holds latest stable|release code
* ``dev`` branch holds current development code
* Work on a dedicated branch starting off ``dev``
* I like fast forward merges, **please rebase on** ``dev`` branch before submitting changes
* Advertise your work (cf. Note)

.. NOTE::
    **Git merge Workflow** |br|
    I currently don't care about a specific workflow concerning changes submission. |br|
    Don't bother with gitlab merge request or gh pull request. |br|
    All we need is a public git repo and a ref to fetch from as long you rebased on ``dev`` branch.

Coding
-------

* follow pep8
* write unittest
* actually test your code (unit and functional testing)


.. _`learn if needed`: https://git-scm.com/book/

.. |br| raw:: html

    <br />

.. vim: spell spelllang=en