quiet some mismatched indentation warnings
[unicorn.git] / ISSUES
blob610f0118de8874bc7e88b69c0607b8a27f834571
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}[https://bogomips.org/unicorn-public/] and
6 {documentation}[https://bogomips.org/unicorn/].
8 * No subscription will ever be required to email us
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,
13   they hurt reader privacy and will be flagged as spam
14 * Anonymous and pseudonymous messages will ALWAYS be welcome
15 * The email submission port (587) is enabled on the bogomips.org MX:
16   https://bogomips.org/unicorn-public/20141004232241.GA23908@dcvr.yhbt.net/t/
18 We will never have a centralized or formal bug tracker.  Instead we
19 can interoperate with any bug tracker which can Cc: us plain-text to
20 mailto:unicorn-public@bogomips.org   This includes the Debian BTS
21 at https://bugs.debian.org/unicorn and possibly others.
23 If your issue is of a sensitive nature or you're just shy in public,
24 use anonymity tools such as Tor or Mixmaster; and rely on the public
25 mail archives for responses.  Be sure to scrub sensitive log messages
26 and such.
28 If you don't get a response within a few days, we may have forgotten
29 about it so feel free to ask again.
31 == Bugs in related projects
33 unicorn is sometimes affected by bugs in its dependencies.  Bugs
34 triggered by unicorn in mainline Ruby, rack, GNU C library (glibc),
35 or the Linux kernel will be reported upstream and fixed.
37 For bugs in Ruby itself, we may forward bugs to
38 https://bugs.ruby-lang.org/ and discuss+fix them on the ruby-core
39 list at mailto:ruby-core@ruby-lang.org
40 Subscription to post is required to ruby-core, unfortunately:
41 mailto:ruby-core-request@ruby-lang.org?subject=subscribe
43 For uncommon bugs in Rack, we may forward bugs to
44 mailto:rack-devel@googlegroups.com and discuss there.
45 Subscription (without any web UI or Google account) is possible via:
46 mailto:rack-devel+subscribe@googlegroups.com
47 Note: not everyone can use the proprietary bug tracker used by Rack,
48 but their mailing list remains operational.
50 Uncommon bugs we encounter in the Linux kernel should be Cc:-ed to the
51 Linux kernel mailing list (LKML) at mailto:linux-kernel@vger.kernel.org
52 and subsystem maintainers such as mailto:netdev@vger.kernel.org
53 (for networking issues).  It is expected practice to Cc: anybody
54 involved with any problematic commits (including those in the
55 Signed-off-by: and other trailer lines).  No subscription is necessary,
56 and the our mailing list follows the same conventions as LKML for
57 interopability.  There is a kernel.org Bugzilla instance, but it is
58 ignored by most developers.
60 Likewise for any rare glibc bugs we might encounter, we should Cc:
61 mailto:libc-alpha@sourceware.org
62 Keep in mind glibc upstream does use Bugzilla for tracking bugs:
63 https://sourceware.org/bugzilla/
65 == Submitting Patches
67 See the HACKING document (and additionally, the
68 {SubmittingPatches}[https://git.kernel.org/cgit/git/git.git/tree/Documentation/SubmittingPatches]
69 document distributed with git) on guidelines for patch submission.
71 == Contact Info
73 * public: mailto:unicorn-public@bogomips.org
74 * nntp://news.gmane.org/gmane.comp.lang.ruby.unicorn.general
75 * nntp://news.public-inbox.org/inbox.comp.lang.ruby.unicorn
76 * https://bogomips.org/unicorn-public/
77 * http://ou63pmih66umazou.onion/unicorn-public/
79 Mailing list subscription is optional, so Cc: all participants.
81 You can follow along via NNTP (read-only):
83         nntp://news.public-inbox.org/inbox.comp.lang.ruby.unicorn
84         nntp://news.gmane.org/gmane.comp.lang.ruby.unicorn.general
86 Or Atom feeds:
88         https://bogomips.org/unicorn-public/new.atom
89         http://ou63pmih66umazou.onion/unicorn-public/new.atom
91         The HTML archives at https://bogomips.org/unicorn-public/
92         also has links to per-thread Atom feeds and downloadable
93         mboxes.
95 You may optionally subscribe via plain-text email:
97         mailto:unicorn-public+subscribe@bogomips.org
98         (and confirming the auto-reply)
100 Just keep in mind we suck at delivering email, so using NNTP,
101 or Atom feeds might be a better bet...