doc: v3 .onion updates, nntp => nntps, minor wording changes
[unicorn.git] / ISSUES
blob015de37c7f7cdb20fbc36729462f12800d2ead06
1 = Issues
3 mailto:unicorn-public@yhbt.net is the best place to report bugs,
4 submit patches and/or obtain support after you have searched the
5 {email archives}[https://yhbt.net/unicorn-public/] and
6 {documentation}[https://yhbt.net/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 yhbt.net MX:
16   https://yhbt.net/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@yhbt.net   This includes the Debian BTS
21 at https://bugs.debian.org/unicorn and possibly others.
23 unicorn is a server; it does not depend on graphics/audio.  Nobody
24 communicating with us will ever be expected to go through the trouble
25 of setting up graphics nor audio support.
27 If your issue is of a sensitive nature or you're just shy in public,
28 use anonymity tools such as Tor or Mixmaster; and rely on the public
29 mail archives for responses.  Be sure to scrub sensitive log messages
30 and such.
32 If you don't get a response within a few days, we may have forgotten
33 about it so feel free to ask again.
35 == Bugs in related projects
37 unicorn is sometimes affected by bugs in its dependencies.  Bugs
38 triggered by unicorn in mainline Ruby, rack, GNU C library (glibc),
39 or the Linux kernel will be reported upstream and fixed.
41 For bugs in Ruby itself, we may forward bugs to
42 https://bugs.ruby-lang.org/ and discuss+fix them on the ruby-core
43 list at mailto:ruby-core@ruby-lang.org
44 Subscription to post is required to ruby-core, unfortunately:
45 mailto:ruby-core-request@ruby-lang.org?subject=subscribe
46 Unofficial archives are available at: https://public-inbox.org/ruby-core/
48 For uncommon bugs in Rack, we may forward bugs to
49 mailto:rack-devel@googlegroups.com and discuss there.
50 Subscription (without any web UI or Google account) is possible via:
51 mailto:rack-devel+subscribe@googlegroups.com
52 Note: not everyone can use the proprietary bug tracker used by Rack,
53 but their mailing list remains operational.
54 Unofficial archives are available at: https://public-inbox.org/rack-devel/
56 Uncommon bugs we encounter in the Linux kernel should be Cc:-ed to the
57 Linux kernel mailing list (LKML) at mailto:linux-kernel@vger.kernel.org
58 and subsystem maintainers such as mailto:netdev@vger.kernel.org
59 (for networking issues).  It is expected practice to Cc: anybody
60 involved with any problematic commits (including those in the
61 Signed-off-by: and other trailer lines).  No subscription is necessary,
62 and the our mailing list follows the same conventions as LKML for
63 interopability. Archives are available at https://lore.kernel.org/lkml/
64 There is a kernel.org Bugzilla instance, but it is ignored by most.
66 Likewise for any rare glibc bugs we might encounter, we should Cc:
67 mailto:libc-alpha@sourceware.org
68 Unofficial archives are available at: https://public-inbox.org/libc-alpha/
69 Keep in mind glibc upstream does use Bugzilla for tracking bugs:
70 https://sourceware.org/bugzilla/
72 == Submitting Patches
74 See the HACKING document (and additionally, the
75 {SubmittingPatches}[https://git.kernel.org/cgit/git/git.git/tree/Documentation/SubmittingPatches]
76 document distributed with git) on guidelines for patch submission.
78 == Contact Info
80 Mail is publicly-archived, SMTP subscription is discouraged to avoid
81 servers being a single-point-of-failure, so Cc: all participants.
83 The HTTP(S) archives have links to per-thread Atom feeds and downloadable
84 mboxes.  Read-only IMAP(S) folders and NNTP(S) newsgroups are also available.
86 * https://yhbt.net/unicorn-public/
87 * http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/unicorn-public/
88 * imaps://yhbt.net/inbox.comp.lang.ruby.unicorn.0
89 * imap://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/inbox.comp.lang.ruby.unicorn.0
90 * nntps://news.public-inbox.org/inbox.comp.lang.ruby.unicorn
91 * nntp://news.gmane.io/gmane.comp.lang.ruby.unicorn.general
93 Full Atom feeds:
94 * https://yhbt.net/unicorn-public/new.atom
95 * http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/unicorn-public/new.atom
97 We only accept plain-text mail: mailto:unicorn-public@yhbt.net