diff options
author | Eric Wong <e@80x24.org> | 2014-04-08 20:42:17 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2014-04-08 20:42:17 +0000 |
commit | 7bca74b9c81e041981e59dde7fbdf904dbd67914 (patch) | |
tree | 7a12e39700ed4a76e5374ce536a072bf86dc158f /Documentation | |
parent | 4740b5ea9816e884ceba237496fc3fb7a50cd023 (diff) | |
download | public-inbox-7bca74b9c81e041981e59dde7fbdf904dbd67914.tar.gz |
Things to keep in mind when working on this.
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/design_notes.txt | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/Documentation/design_notes.txt b/Documentation/design_notes.txt index 6805f046..e7e6fff7 100644 --- a/Documentation/design_notes.txt +++ b/Documentation/design_notes.txt @@ -32,8 +32,9 @@ Use existing infrastructure public-inbox-mda(1) * public-inbox uses SMTP for posting. Posting a message to a public-inbox - instance is no different than sending a message to any open mailing - list. + instance is no different than sending a message to any _open_ mailing + list. Any existing spam filtering on an SMTP server is also effective + on public-inbox. * readers may continue using use their choice of mail clients and mailbox formats, only learning a few commands of the ssoma(1) tool @@ -73,11 +74,32 @@ Why email? public-inbox host becomes unavailable, users may still directly email each other (or Cc: lists for related/dependent projects). -Notes ------ +Why git? +-------- + +* git is distributed and robust while being both fast and + space-efficient with text data. NNTP was considered, but does not + support compression and places no guarantees on data/transport + integrity. However, an NNTP gateway (read-only?) is possible. + +* As of 2014, git is widely used and known to nearly all Free Software + developers. For non-developers it is packaged for all major GNU/Linux + and *BSD distributions. + +Web notes +--------- + +* Getting users to install/run ssoma (or any new tool) is difficult. + The web views must be easily read/cache/mirror-able. + +* There may also be a significant number of webmail users without + an MUA or feed reader; so a web view is necessary. + +* Expose Message-ID in web views to encourage replies from drive-by + contributors. -* Expose Message-ID in HTML views to encourage replies from drive-by - contributors +* Raw text endpoint allows users to write client-side JS endpoints + without hosting the data themselves (or on a different server). Copyright --------- |