summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/bug-snippet.txt')
-rw-r--r--Documentation/bug-snippet.txt35
1 files changed, 35 insertions, 0 deletions
diff --git a/Documentation/bug-snippet.txt b/Documentation/bug-snippet.txt
new file mode 100644
index 0000000..74f6d72
--- /dev/null
+++ b/Documentation/bug-snippet.txt
@@ -0,0 +1,35 @@
+Are you interested in maintaning this driver directly yourself in the new
+printer-drivers overlay [1]?
+
+If yes, just send me via personal e-mail at dilfridge@gentoo.org
+a public ssh key [2], so we can give you git push access to the overlay.
+If you have a gnupg key, you should sign that e-mail [3].
+
+Just a few rules:
+* Initially, the ebuilds should work for you, and not break
+ anything else.
+* You enter yourself as maintainer in metadata.xml (together with
+ the printing herd), and are then automatically cc'ed in bug reports
+ on bugzilla.
+* We will guide you towards improving the ebuilds over the next
+ months so they follow the rules and qa guidelines of the Gentoo
+ main portage tree. In particular this means also using a recent
+ EAPI (3 or perferably 4), and fixing repoman warnings [4].
+ Don't worry, we'll help you with that.
+* I hope this is never going to happen, but... ebuilds that "work but
+ go against the guidelines" and do not see any improvement will be
+ removed again one year after initial addition.
+
+There are many ways to get help.
+* You can directly ask me by personal e-mail (my time is limited,
+ but I'll try),
+* you can ask on freenode, channel #gentoo-dev-help,
+* you can read the documentation (ebuild howto [5], devmanual [6]),
+* ...
+
+[1] http://git.overlays.gentoo.org/gitweb/?p=proj/printer-drivers.git;a=summary
+[2] http://www.gentoo.org/doc/en/articles/openssh-key-management-p1.xml
+[3] http://www.gentoo.org/doc/en/gnupg-user.xml
+[4] http://dev.gentoo.org/~zmedico/portage/doc/man/repoman.1.html
+[5] http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2
+[6] http://devmanual.gentoo.org/