doc updates
[unicorn.git] / ISSUES
blob394c852052259a278e5975519976ab496517b16e
1 = Issues
3 mailto:unicorn-public@bogomips.org is the best place to report bugs,
4 submit patches and/or obtain support after you have searched the
5 {email archives}[http://bogomips.org/unicorn-public/] and
6 {documentation}[http://unicorn.bogomips.org/].
8 * No subscription will ever be required to email the public inbox.
9 * Cc: all participants in a thread or commit, as subscription is optional
10 * Do not {top post}[http://catb.org/jargon/html/T/top-post.html] in replies
11 * Quote as little as possible of the message you're replying to
12 * Do not send HTML mail or images, it will be flagged as spam
13 * Anonymous and pseudonymous messages will always be welcome.
14 * The email submission port (587) is enabled on the bogomips.org MX:
15   http://bogomips.org/unicorn-public/20141004232241.GA23908@dcvr.yhbt.net/t/
17 If your issue is of a sensitive nature or you're just shy in public,
18 then feel free to email us privately at mailto:unicorn@bogomips.org
19 instead and your issue will be handled discreetly.
21 If you don't get a response within a few days, we may have forgotten
22 about it so feel free to ask again.
24 == Bugs in related projects
26 unicorn is sometimes affected by bugs in its dependencies.  Bugs
27 triggered by unicorn in mainline Ruby, rack, GNU C library (glibc),
28 or the Linux kernel will be reported upstream and fixed.
30 For bugs in Ruby itself, we may forward bugs to
31 https://bugs.ruby-lang.org/ and discuss+fix them on the ruby-core
32 list at mailto:ruby-core@ruby-lang.org
33 Subscription to post is required to ruby-core, unfortunately:
34 mailto:ruby-core-request@ruby-lang.org?subject=subscribe
36 For uncommon bugs in Rack, we may forward bugs to
37 mailto:rack-devel@googlegroups.com and discuss there.
38 Subscription (without any web UI or Google account) is possible via:
39 mailto:rack-devel+subscribe@googlegroups.com
40 Note: not everyone can use the proprietary bug tracker used by Rack,
41 but their mailing list remains operational.
43 Uncommon bugs we encounter in the Linux kernel should be Cc:-ed to the
44 Linux kernel mailing list (LKML) at mailto:linux-kernel@vger.kernel.org
45 and subsystem maintainers such as mailto:netdev@vger.kernel.org
46 (for networking issues).  It is expected practice to Cc: anybody
47 involved with any problematic commits (including those in the
48 Signed-off-by: and other trailer lines).  No subscription is necessary,
49 and the our mailing list follows the same conventions as LKML for
50 interopability.  There is a kernel.org Bugzilla instance, but it is
51 ignored by most developers.
53 Likewise for any rare glibc bugs we might encounter, we should Cc:
54 mailto:libc-alpha@sourceware.org
55 Keep in mind glibc upstream does use Bugzilla for tracking bugs:
56 https://sourceware.org/bugzilla/
58 == Submitting Patches
60 See the HACKING document (and additionally, the
61 {SubmittingPatches}[https://git.kernel.org/cgit/git/git.git/tree/Documentation/SubmittingPatches]
62 document distributed with git) on guidelines for patch submission.
64 == Contact Info
66 * public: mailto:unicorn-public@bogomips.org
67 * private: mailto:unicorn@bogomips.org
68 * nntp://news.gmane.org/gmane.comp.lang.ruby.unicorn.general
69 * nntp://news.public-inbox.org/inbox.comp.lang.ruby.unicorn
70 * http://bogomips.org/unicorn-public/
72 We operate a {public-inbox}[http://public-inbox.org/] which
73 feeds the mailing list.  Subscription is optional, so Cc:
74 all participants.
76 You can follow along via NNTP:
78         nntp://news.public-inbox.org/inbox.comp.lang.ruby.unicorn
79         nntp://news.gmane.org/gmane.comp.lang.ruby.unicorn.general
81 Or Atom feeds:
83         http://bogomips.org/unicorn-public/new.atom
85         The HTML archives at http://bogomips.org/unicorn-public/
86         also has links to per-thread Atom feeds and downloadable
87         mboxes.
89 You may also subscribe via plain-text email:
91         mailto:unicorn-public+subscribe@bogomips.org
92         (and confirming the auto-reply)