]> Sergey Matveev's repositories - public-inbox.git/blobdiff - README
public-inbox 1.1.0-pre1
[public-inbox.git] / README
diff --git a/README b/README
index 85b48be81f3faa04687d775ad0c559d355c2974c..26e0b69514df24567cf366468e852f0daad2053b 100644 (file)
--- a/README
+++ b/README
@@ -7,7 +7,7 @@ read via NNTP, Atom feeds or HTML archives.
 
 public-inbox spawned around three main ideas:
 
-* Publically accessible and archived communication is essential to
+* Publicly accessible and archived communication is essential to
   Free Software development.
 
 * Contributing to Free Software projects should not require the
@@ -22,33 +22,31 @@ to run their own instances with minimal overhead.
 Implementation
 --------------
 
-public-inbox uses ssoma[1], Some Sort Of Mail Archiver which implements
-no policy of its own.  By storing (and optionally) exposing an inbox
-via git, it is fast and efficient to host and mirror public-inboxes.
+public-inbox stores mail in a git repository keyed by Message-ID
+as documented in: https://ssoma.public-inbox.org/ssoma_repository.txt
 
-Traditional mailing lists use the "push" model.  For readers, this
-requires commitment to subscribe and effort to unsubscribe.  New readers
-may also have difficulty following existing discussions if archives do
-not expose Message-ID headers for responses.  List server admins may be
-burdened with delivery failures.
+By storing (and optionally) exposing an inbox via git, it is
+fast and efficient to host and mirror public-inboxes.
 
-public-inbox uses the "pull" model.  Casual readers may also follow
-the list via NNTP, Atom feed or HTML archives.
+Traditional mailing lists use the "push" model.  For readers,
+that requires commitment to subscribe and effort to unsubscribe.
+New readers may also have difficulty following existing
+discussions if archives do not expose Message-ID and References
+headers.  List server admins are also burdened with delivery
+failures.
 
-Users of the ssoma[1] command-line tool may import mail into an mbox,
-Maildir, or IMAP folder from git repositories periodically.
+public-inbox uses the "pull" model.  Casual readers may also
+follow the list via NNTP, Atom feed or HTML archives.
 
 If a reader loses interest, they simply stop syncing.
 
 Since we use git, mirrors are easy-to-setup, and lists are
-easy-to-relocate to different mail addresses without losing/splitting
-archives.
+easy-to-relocate to different mail addresses without losing
+or splitting archives.
 
 _Anybody_ may also setup a delivery-only mailing list server to
 replay a public-inbox git archive to subscribers via SMTP.
 
-[1] http://ssoma.public-inbox.org/
-
 Features
 --------
 
@@ -60,7 +58,7 @@ Features
 
 * uses only well-documented and easy-to-implement data formats
 
-Try it out now, see http://try.public-inbox.org/
+Try it out now, see https://try.public-inbox.org/
 
 Requirements for reading:
 
@@ -82,14 +80,16 @@ Requirements (participant)
 Requirements (server)
 ---------------------
 
-See http://public-inbox.org/INSTALL
+See https://public-inbox.org/INSTALL
 
 Hacking
 -------
 
-Source code is available via git:
+AGPL source code is available via git:
 
-       git clone git://80x24.org/public-inbox
+       git clone https://public-inbox.org/ public-inbox
+       git clone git://repo.or.cz/public-inbox
+       torsocks git clone http://hjrcffqmbrq6wope.onion/public-inbox
 
 See below for contact info.
 
@@ -111,15 +111,21 @@ on git@vger.kernel.org).
 The archives are readable via NNTP or HTTP:
 
        nntp://news.public-inbox.org/inbox.comp.mail.public-inbox.meta
-       http://public-inbox.org/meta/
+       https://public-inbox.org/meta/
+
+And as Tor hidden services:
+
+       http://hjrcffqmbrq6wope.onion/meta/
+       nntp://hjrcffqmbrq6wope.onion/inbox.comp.mail.public-inbox.meta
 
 You may also clone all messages via git:
 
-       git clone --mirror git://public-inbox.org/meta.git
+       git clone --mirror https://public-inbox.org/meta/
+       torsocks git clone --mirror http://hjrcffqmbrq6wope.onion/meta/
 
 Or pass the same git repository URL for ssoma using the instructions at:
 
-       http://ssoma.public-inbox.org/README.html
+       https://ssoma.public-inbox.org/README.html
 
 Anti-Spam
 ---------
@@ -128,15 +134,15 @@ The maintainer of public-inbox has found SpamAssassin a good tool for
 filtering his personal mail, and it will be the default spam filtering
 tool in public-inbox.
 
-See http://public-inbox/dc-dlvr-spam-flow.html for more info.
+See https://public-inbox.org/dc-dlvr-spam-flow.html for more info.
 
 Content Filtering
 -----------------
 
-To discourage phishing, web bugs (tracking), viruses and other nuisances,
-only plain-text content is allowed and non-text content is stripped.
-This saves I/O bandwidth and storage, which is important as
-entire mail archives are shared between clients.
+To discourage phishing, trackers, exploits and other nuisances,
+only plain-text emails are allowed and HTML is rejected.
+This improves accessibility, and saves bandwidth and storage
+as mail is archived forever.
 
 As of the 2010s, successful online social networks and forums are the
 ones which heavily restrict users formatting options; so public-inbox
@@ -145,8 +151,8 @@ aims to preserve the focus on content, and not presentation.
 Copyright
 ---------
 
-Copyright 2013-2015 all contributors <meta@public-inbox.org>
-License: AGPLv3 or later <http://www.gnu.org/licenses/agpl-3.0.txt>
+Copyright 2013-2018 all contributors <meta@public-inbox.org>
+License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as published by
@@ -159,7 +165,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU Affero General Public License for more details.
 
 You should have received a copy of the GNU Affero General Public License
-along with this program.  If not, see <http://www.gnu.org/licenses/>.
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 Additional permission under GNU GPL version 3 section 7: