CONTRIBUTING 1.6 KB
Newer Older
Mattia Rizzolo's avatar
Mattia Rizzolo committed
1
== disclaimer
2 3

We are happy to take *untested* patches. Patches are reviewed before merging
4
but no one has a complete test environment for all jobs, so please publish
Holger Levsen's avatar
Holger Levsen committed
5
your well meant and untested patches as soon as they are ready!
6

7
=== Contributing code to this project
8 9

It's helpful to track fixes or new features via wishlist bugs against the
10
'jenkins.debian.org' package, eg with the 'reportbug' tool ('devscripts' package).
11
The BTS will ensure the developers' mailing list
12
   qa-jenkins-dev@lists.debian.org
13 14
is notified.

15
The code is available in the link:https://salsa.debian.org/qa/jenkins.debian.net[jenkins.debian.net GIT repository].
16

17
Patches can be submitted as requests to pull from a publicly-visible 
18 19
git repository (this is the preferred way) communicated via IRC or mail,
or completely via mail (using git format-patch, see below).
20
If appropriate, please make a topic branch based on the 'master' branch.
21

Mattia Rizzolo's avatar
Mattia Rizzolo committed
22
You can send patches or requests to the link:mailto:qa-jenkins-dev@lists.alioth.debian.org[development list],
23 24 25
or to the tracking bug: <bugnumber>@bugs.debian.org.

One possible workflow:
Holger Levsen's avatar
Holger Levsen committed
26
----
27
  git clone https://salsa.debian.org/qa/jenkins.debian.net
28
  git checkout origin/master -b <topicname>
Holger Levsen's avatar
Holger Levsen committed
29
  # <edits>
30 31 32
  git commit -a
  git format-patch -M origin/master

33
  reportbug jenkins.debian.org
Holger Levsen's avatar
Holger Levsen committed
34 35
  # <describe the issue, attach the patch>
----
36

37 38
=== Contributing bugs to other projects

39 40
Another very useful type of contributions are filing bug reports based
on jenkins job runs. Another useful kind of contribution would be to
41
improve the documentation, eg to better describe how to debug stuff.
42 43

// vim: set filetype=asciidoc: