git ssb

9+

mixmix / ssb-handbook



Commit acc5fc2c5308b4818c8fdfabedc4a27e010756c0

Explanation of scuttle terminology, repos and history to move to modules section (#36)

* added explanation: Secure-scuttlebutt vs scuttlebutt vs scuttlebot vs sbot?

* ignore npm debug log

* move scuttle terminology to modules section
av8ta authored on 4/21/2017, 10:56:45 AM
Mikey committed on 4/21/2017, 10:56:45 AM
Parent: dea927468026e7d091af12342c633eb9db5b68b9

Files changed

.gitignorechanged
modules.mdchanged
.gitignoreView
@@ -1,2 +1,3 @@
11 node_modules
22 _book
3 +npm-debug.log
modules.mdView
@@ -1,14 +1,30 @@
11 # Modules
22
3-> isaacs (creator of npm) puts it very well: agreement is very difficult, so limit the amount of agreement necessary.
3 +> Isaac Schlueter (creator of npm) puts it very well: agreement is very difficult, so limit the amount of agreement necessary.
44 >
55 > i.e. write modules.
66 >
77 > With less agreement required, it's easier to find points of agreement, and so we can have _more_ agreements overall.
88
99 - %88KMgyXpuyF1O1VtKjkycJ+R5j7sJ/DgFwLVAS19J4U=.sha256
1010
11 +## Secure-scuttlebutt vs scuttlebutt vs scuttlebot vs sbot?
12 +#### An explanation of terms, repos and project history
13 +
14 +- [`scuttlebutt`](https://github.com/dominictarr/scuttlebutt): a [`gossip protocol`](https://en.wikipedia.org/wiki/Gossip_protocol) that synchronises messages via a vector clock of per-node timestamps or sequences. Dominic got this name from an amazon paper ["Efficient Reconciliation and Flow Control for Anti-Entropy Protocols"](https://www.cs.cornell.edu/home/rvr/papers/flowgossip.pdf). This is the original scuttlebutt module which should now be known as "insecure scuttlebutt". This repo is generally no longer used by the ssb community.
15 +
16 +- [`secure-scuttlebutt`](https://github.com/ssbc/secure-scuttlebutt): this is the **database** part of **ssb**. Previously this term referred to the protocol/database as a whole.
17 +
18 +- [`scuttlebot`](https://github.com/ssbc/scuttlebot): this repo adds **networking behaviour** to the database (secure-scuttlebutt).
19 +
20 +- [`sbot`](https://github.com/ssbc/scuttlebot): short for **scuttlebot**, also the cli command name.
21 +
22 +There have been suggestions to rename some repos to better reflect their use and purpose:
23 +
24 +secure-scuttlebutt --> [`ssb-db `](https://github.com/ssbc/secure-scuttlebutt/issues/159)
25 +scuttlebot --> [`ssb-server`](https://github.com/ssbc/scuttlebot/issues/378)
26 +
1127 ## Streams
1228
1329 - [`pull-stream`](https://pull-stream.github.io): minimal composable streams with lazy back pressure and error propagation
1430 - [`mutant`](https://github.com/mmckegg/mutant): lazy observables and reactive html elements

Built with git-ssb-web