yahns Ruby server user/dev discussion
 help / color / Atom feed
From: Eric Wong <e@80x24.org>
To: yahns-public@yhbt.net
Subject: [PATCH] doc: update wording to avoid "mailing list"
Date: Sun, 21 Apr 2019 23:35:13 +0000
Message-ID: <20190421233513.5523-1-e@80x24.org> (raw)

The concept of a "mailing list" infers the existence of a
centralized subscriber list, and hurts forkability.  The
"public inbox" concept is a more accurate description and
mostly centralization-resistant, aside from domain names.
---
 Documentation/yahns-rackup.pod |  4 ++--
 Documentation/yahns.pod        |  2 +-
 Documentation/yahns_config.pod |  4 ++--
 HACKING                        | 11 +++++------
 README                         | 13 +++++++------
 5 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/Documentation/yahns-rackup.pod b/Documentation/yahns-rackup.pod
index de2d4b6..617a514 100644
--- a/Documentation/yahns-rackup.pod
+++ b/Documentation/yahns-rackup.pod
@@ -166,8 +166,8 @@ See rackup documentation for more details.
 =head1 CONTACT
 
 All feedback welcome via plain-text mail to L<mailto:yahns-public@yhbt.net>
-No subscription is necessary to post to the mailing list.
-List archives are available at L<https://yhbt.net/yahns-public/>
+No subscription is necessary to email us.
+Mail archives are available at L<https://yhbt.net/yahns-public/>
 
 =head1 COPYRIGHT
 
diff --git a/Documentation/yahns.pod b/Documentation/yahns.pod
index 5d505ce..1954584 100644
--- a/Documentation/yahns.pod
+++ b/Documentation/yahns.pod
@@ -83,7 +83,7 @@ See L<yahns_config(5)> for documentation on the configuration file format.
 =head1 CONTACT
 
 All feedback welcome via plain-text mail to L<mailto:yahns-public@yhbt.net>
-No subscription is necessary to post to the mailing list.
+No subscription is necessary to email us.
 Mail archives are available at L<https://yhbt.net/yahns-public/>
 
 =head1 COPYRIGHT
diff --git a/Documentation/yahns_config.pod b/Documentation/yahns_config.pod
index 5d0e441..01b1bf9 100644
--- a/Documentation/yahns_config.pod
+++ b/Documentation/yahns_config.pod
@@ -661,8 +661,8 @@ See the examples/ directory in the git source tree.
 =head1 CONTACT
 
 All feedback welcome via plain-text mail to L<mailto:yahns-public@yhbt.net>
-No subscription is necessary to post to the mailing list.
-List archives are available at L<https://yhbt.net/yahns-public/>
+No subscription is necessary to email us.
+Mail archives are available at L<https://yhbt.net/yahns-public/>
 
 =head1 COPYRIGHT
 
diff --git a/HACKING b/HACKING
index 6d73fc1..5a63e7b 100644
--- a/HACKING
+++ b/HACKING
@@ -42,15 +42,14 @@ installing from git
 contact
 -------
 
-We use git(7) and develop yahns on a public mailing list like git
-developers do.  Please send patches via git-send-email(1) to the public
-mailing list at <yahns-public@yhbt.net>.  Pull requests should be
-formatted using git-request-pull(1).
+We use git(7) and develop yahns using email like git.git hackers do.
+Please send patches via git-send-email(1) to us at <yahns-public@yhbt.net>.
+Pull requests should be formatted using git-request-pull(1).
 
 All mail is archived publically at: https://yhbt.net/yahns-public/
 Anonymous contributions will always be welcome.
-No subscription is necessary to post to the mailing list.
-Please remember to Cc: all recipients as subscription is optional.
+No subscription is necessary to email us.
+Please remember to reply-to-all as we do not encourage subscription.
 
 Copyright (C) 2013-2016 all contributors <yahns-public@yhbt.net>
 License: GPL-3.0+ <https://www.gnu.org/licenses/gpl-3.0.txt>
diff --git a/README b/README
index 0e4bc4a..2cd0e92 100644
--- a/README
+++ b/README
@@ -56,15 +56,16 @@ Contact
 
 We are happy to see feedback of all types via plain-text email.
 Please send comments, user/dev discussion, patches, bug reports,
-and pull requests to the open-to-all mailing list at:
+and pull requests to our public inbox at:
 
 	yahns-public@yhbt.net
 
-No subscription is necessary to post.  Please Cc: all recipients as
-subscription is not necessary.
+Please use reply-to-all as we do not require any sort of subscription.
+We archive all of our mail publically at:
+
+	https://yhbt.net/yahns-public/
+	nntp://news.public-inbox.org/inbox.comp.lang.ruby.yahns
 
-Mailing list archives browsable via HTTPS: https://yhbt.net/yahns-public/
-Or NNTP: nntp://news.public-inbox.org/inbox.comp.lang.ruby.yahns
 Atom feed: https://yhbt.net/yahns-public/new.atom
 
 This README is our homepage, we would rather be working on HTTP servers
@@ -77,7 +78,7 @@ Hacking
 -------
 
 We use git and follow the same development model as git itself
-(mailing list-oriented, benevolent dictator).
+(email-oriented, benevolent dictator).
 
 	git clone https://yhbt.net/yahns.git
 
-- 
EW


             reply index

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-04-21 23:35 Eric Wong [this message]
2019-04-21 23:35 Eric Wong

Reply instructions:

You may reply publically to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://yhbt.net/yahns/README

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20190421233513.5523-1-e@80x24.org \
    --to=e@80x24.org \
    --cc=yahns-public@yhbt.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

yahns Ruby server user/dev discussion

Archives are clonable:
	git clone --mirror https://yhbt.net/yahns-public
	git clone --mirror http://ou63pmih66umazou.onion/yahns-public

Example config snippet for mirrors

Newsgroups are available over NNTP:
	nntp://news.public-inbox.org/inbox.comp.lang.ruby.yahns
	nntp://ou63pmih66umazou.onion/inbox.comp.lang.ruby.yahns

 note: .onion URLs require Tor: https://www.torproject.org/

AGPL code for this site: git clone https://public-inbox.org/public-inbox.git