git ssb - Merge branch 'adding-faq' · mixmix/ssb-handbook@af3a8cfa

Commit af3a8cfa08969dc0aedf26281692d849edfec3af

Merge branch 'adding-faq'

Conflicts:
	.gitignore

Michael Williams committed on 5/1/2017, 12:50:58 AM
Parent: acc5fc2c5308b4818c8fdfabedc4a27e010756c0
Parent: b25b64cc218dc8c3e09da573da5fcf7a788b213d

Files changed

.gitignore	changed
SUMMARY.md	changed
assets/web.css	changed
faq/applications/applications.md	added
faq/applications/moving-ssb-apps.md	added
faq/applications/multiple-devices.md	added
faq/applications/patchwork-and-patchbay.md	added
faq/basics/basics.md	added
faq/basics/data-live.md	added
faq/basics/delete.md	added
faq/basics/gossip.md	added
faq/basics/patchwork-vs-scuttlebutt.md	added
faq/basics/pub.md	added
faq/basics/size.md	added
faq/channels/channel-find.md	added
faq/channels/channel-messages.md	added
faq/channels/channel-sort.md	added
faq/channels/channel-start.md	added
faq/channels/channels-index.md	added
faq/channels/channels.md	added
faq/index.md	added
faq/misc/concepts.md	added
faq/misc/cool.md	added
faq/misc/faq-credits.md	added
faq/misc/help.md	added
faq/misc/resources.md	added

.gitignoreView
		@@ -1,3 +1,4 @@
1	1 …	node_modules
2	2 …	_book
3		-npm-debug.log
	3 …	+npm-debug.log
	4 …	+.DS_store

SUMMARY.mdView
		@@ -2,8 +2,29 @@
2	2 …	* [Contributing](contributing.md)
3	3 …	* [Talks](talks.md)
4	4 …	* [Applications](applications.md)
5	5 …	* [Principles](principles.md)
	6 …	+* [FAQ](faq/index.md)
	7 …	+ - [Basics](faq/basics/basics.md)
	8 …	+ - [What is the difference between Patchwork and Scuttlebutt?](faq/basics/patchwork-vs-scuttlebutt.md)
	9 …	+ - [What is a pub?](faq/basics/pub.md)
	10 …	+ - [What do you mean SSB works through gossip?](faq/basics/gossip.md)
	11 …	+ - [Where does all my data live?](faq/basics/data-live.md)
	12 …	+ - [How much space will scuttlebutt take up?](faq/basics/size.md)
	13 …	+ - [What happens if I delete everything?](faq/basics/delete.md)
	14 …	+ - [Applications](faq/applications/applications.md)
	15 …	+ - [How do posts work across apps?](faq/applications/patchwork-and-patchbay.md)
	16 …	+ - [Can I switch apps easily?](faq/applications/moving-ssb-apps.md)
	17 …	+ - [Can I post from different devices?](faq/applications/multiple-devices.md)
	18 …	+ - [Channels](faq/channels/channels-index.md)
	19 …	+ - [What are channels?](faq/channels/channels.md)
	20 …	+ - [Are Channels sorted in any order?](faq/channels/channel-sort.md)
	21 …	+ - [How do channel descriptions work?](faq/channels/channel-messages.md)
	22 …	+ - [How do I find a channel?](faq/channels/channel-find.md)
	23 …	+ - [Misc.](faq/misc/concepts.md)
	24 …	+ - [This seems really cool?](faq/misc/cool.md)
	25 …	+ - [Who wrote this FAQ?](faq/misc/faq-credits.md)
	26 …	+ - [How can I help?](faq/misc/help.md)
6	27 …	* [Stories](stories/index.md)
7	28 …	- [Design Challenge: Avoid Centralization and Singletons](stories/design-challenge-avoid-centralization-and-singletons.md)
8	29 …	- [Design Challenge: Sybil Attacks](stories/design-challenge-sybil-attacks.md)
9	30 …	- [Gossiping Securely is the new Email](stories/gossiping-securely-is-the-new-email.md)

assets/web.cssView
		@@ -17,5 +17,7 @@
17	17 …	}
18	18 …	.summary .custom-link {
19	19 …	display: none;
20	20 …	}
21		-
	21 …	+nav .summary .articles .chapter a {
	22 …	+ white-space: normal;
	23 …	+}

faq/applications/applications.mdView
		@@ -1,0 +1,8 @@
	1 …	+# Applications
	2 …	+Questions around the different ssb-apps and how they work
	3 …	+
	4 …	+## Questions
	5 …	+
	6 …	+- [If I am on Patchwork, can I read messages my friends post on Patchbay?](patchwork-and- patchbay.md)
	7 …	+- [If I decide to move from one Scuttlebutt app to another, can I keep my feed and history? ](moving-ssb-apps.md)
	8 …	+- [Can I use scuttlebutt on different devices, but maintain the same identity? (For example: updating my Patchwork feed from my home or work computer?)](multiple-devices.md)

faq/applications/moving-ssb-apps.mdView
		@@ -1,0 +1,11 @@
	1 …	+# Can I switch apps easily?
	2 …	+
	3 …	+If I decide to move from one Scuttlebutt app to another, can I keep my feed and history?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+Yep! If you use the same private key (found at .ssb/secret). This is a short answer...but there's not much else to say. Scuttlebutt is simple and cool that way.
	8 …	+
	9 …	+---
	10 …	+Sources
	11 …	+* The answer is taken from [this thread.](https://viewer.scuttlebot.io/%25m8%2B25i3i5LCRioA%2FCAqARVb0HNA6TTdvi4B0CxBd8eo%3D.sha256) Shoutout to @ralphtheninja for the awesome answer.

faq/applications/multiple-devices.mdView
		@@ -1,0 +1,13 @@
	1 …	+# Can I post from different devices?
	2 …	+
	3 …	+Or rather: can I use scuttlebutt on different devices, but maintain the same identity? For example: updating my Patchwork feed from my home and work computer?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+Currently, you cannot. Identities are tied to a single user on a single device. You could use scuttlebutt on multiple devices, but you would be maintaining multiple identities and feeds.
	8 …	+
	9 …	+There is an ongoing conversation around this, though, that you can follow [here](https://viewer.scuttlebot.io/%25PwYjgBO4qwpz4ya%2BFLiXphHyuwdFHntrMGd%2FbXJc17o%3D.sha256)
	10 …	+
	11 …	+---
	12 …	+Sources
	13 …	+* Answer taken from the continuing discussion posted above. Shoutos to @feliciousX for getting this particular discussions started, and too many scuttlebutts to name who are continuing to figure this out.

faq/applications/patchwork-and-patchbay.mdView
		@@ -1,0 +1,17 @@
	1 …	+# How do posts work across apps?
	2 …	+
	3 …	+If I am on Patchwork, can I read messages my friends post on Patchbay?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+Generally yes, but it depends on the type of message.
	8 …	+
	9 …	+Everything you do through SSB is considered a message, but there are different types of messages you can send. So making a friend, adding a display picture, or posting your recipe on baked beans are all messages; each of a different type. As SSB grows, so will the breadth of messages it is capable of sharing. Today you can use SSB to not only send status updates, but also update code through git pull requests, or upload and share songs.
	10 …	+
	11 …	+However, different applications will have different _opinions_ on what types of messages it can send and receive. For example: Patchwork, as the family station wagon, is concerned with general posts, display images, profiles, and friends. It doesn't track any pull requests sent through git-ssb. Patchbay, on the other hand, is a pickup truck built for utility and so handles everything Patchwork can handle plus git messages and more.
	12 …	+
	13 …	+What this means is that if you are on Patchwork and your friend is on Patchbay, and your friend posts their opinion on John Wick 2, you will be able to see it. But if your friend makes a pull request to update the code on their John Wick 2 dating sim, you would not be able to see it because Patchwork has no opinion on that type of message.
	14 …	+
	15 …	+---
	16 …	+Sources
	17 …	+* The answer is compiled from multiple posts from [this thread.](https://viewer.scuttlebot.io/%25m8%2B25i3i5LCRioA%2FCAqARVb0HNA6TTdvi4B0CxBd8eo%3D.sha256) Shoutout to @ralphtheninja for the awesome answer.

faq/basics/basics.mdView
		@@ -1,0 +1,13 @@
	1 …	+# Basics
	2 …	+
	3 …	+Questions about scuttlebutt in general, and confusions that come up when folks first get started.
	4 …	+
	5 …	+# Questions
	6 …	+
	7 …	+- [What is the difference between Patchwork and Scuttlebutt?](patchwork-vs-scuttlebutt.md)
	8 …	+- [What is a pub?](pub.md)
	9 …	+- [What do you mean when you say SSB works with Gossip?](gossip.md)
	10 …	+- [Where does all my data live?](data-live.md)
	11 …	+- [How much space will scuttlebutt take up on my computer?](size.md)
	12 …	+- [What happens if I unfollowed all my friends and deleted my .ssb folder? Would all my messages disappear from the scuttleverse?](delete.md)
	13 …	+

faq/basics/data-live.mdView
		@@ -1,0 +1,19 @@
	1 …	+# Where does all my data live?
	2 …	+
	3 …	+---
	4 …	+
	5 …	+It lives on your computer, your friends computers, and your friends' friends computers.
	6 …	+
	7 …	+ When you connect to a friend over an application like Patchwork, you are syncing the diaries that live on your computers, and making sure they hold the same relevant information. This helps explain how no internet connection is needed: as long as there is _any_ way for your two computers to talk to each other, you can catch up on each other's feed.
	8 …	+
	9 …	+ On your computer, your diary lives as a hidden directory within your home directory. You can find it by opening up your terminal and, from the home directory, typing in `ls -a`. The scuttlebutt directory is called `.ssb.`
	10 …	+
	11 …	+The messages you've sent live in a leveldb database within this folder (specifically at `.ssb/db`. They are stored in binary form and so are pure gibberish if you try to read them directly from that folder.
	12 …	+
	13 …	+Additional Resources
	14 …	+
	15 …	+- If the command line and terminals are new to you, here is a great in-depth introduction:
	16 …	+[Taming the Terminal](https://www.bartbusschots.ie/s/blog/taming-the-terminal/)
	17 …	+
	18 …	+Sources
	19 …	+* Answer compiled mostly from experience and [this thread.](https://viewer.scuttlebot.io/%25bUEQtn85jtL8Vxjup4sS%2F7wcaswS4fThUPVH7G5IvjU%3D.sha256) Shoutouts to @cryptix for the answer on encryption and the leveldb database.

faq/basics/delete.mdView
		@@ -1,0 +1,13 @@
	1 …	+# What happens if I delete everything?
	2 …	+
	3 …	+What happens if I unfollow all my friends and delete my .ssb folder? Will all my messages disappear from the scuttleverse?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+Your feed would be deleted off of your computer, but would remain on your friends'(and friends of friends) computers. Your messages would remain as long as your friends remained connected, but they might be harder to find in the future as the network grows.
	8 …	+
	9 …	+In this, again, it is similar to real-life social relationships. If you decide one day to ditch all your friends and move away...it doesn't mean these friends will forget about you. And they may still talk about that one time you screamsang Carly Rae Jepsen at karaoke. But as life continues, and you all make new friends and connections and live new stories, that specific memory may become harder to recall.
	10 …	+
	11 …	+---
	12 …	+Sources
	13 …	+* Answer compiled from [this thread.](https://viewer.scuttlebot.io/%259tfp%2F8bCful8ZvMskklXYO6C%2F7%2FgIaBKH9jNwJI6%2BTM%3D.sha256) Shoutouts to @claytonkoenig for asking the question, and to @ezdiy and @keks for their answers.

faq/basics/gossip.mdView
		@@ -1,0 +1,18 @@
	1 …	+# What do you mean when you say SSB works with Gossip?
	2 …	+
	3 …	+Is gossip some esoteric computer science protocol, or do you mean like real-life gossip?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+Both!
	8 …	+
	9 …	+Part of the philosophy behind Scuttlebutt is that software should better represent how humans actually relate. The connections between humans should map approximately to the connection between their computers. In other words, the architecture beneath everything is inspired by actual human behavior, and is built to function like human behavior.
	10 …	+
	11 …	+There are some great pages posted on scuttlebutt.nz that go into gossip as a protocol,[found here](https://www.scuttlebutt.nz/concepts/gossip.html). But gossip as a concept-- you meet to talk to your friends about your mutual friends and catch up on what everyone's been up to and saying-- serves as a great summary of how scuttlebutt functions.
	12 …	+
	13 …	+
	14 …	+----
	15 …	+
	16 …	+Sources
	17 …	+* Answer taken from section of [this thread.](https://viewer.scuttlebot.io/%25m8%2B25i3i5LCRioA%2FCAqARVb0HNA6TTdvi4B0CxBd8eo%3D.sha256) Shoutouts to @ferrouswheel for asking the question!
	18 …	+

faq/basics/patchwork-vs-scuttlebutt.mdView
		@@ -1,0 +1,23 @@
	1 …	+# What Is the Difference Between Patchwork and Scuttlebutt?
	2 …	+
	3 …	+And what is patchbay, and ssb, and every other mysterious term I've been hearing?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+Scuttlebutt is the general idea or concept around all of this. It's definition is loose, and is often just meant to refer to this entire _thing_, in the way someone refers to "the internet" or "this afternoon". In this case, the _thing_ is the idea of a network organized similar to an actual social graph, which communicates messages in a way similar to gossip.
	8 …	+
	9 …	+SSB stands for SecureScuttleButt. It is the protocol through which we can exchange messages, read each others' feeds, and make friends. You could compare it to [TCP](https://en.wikipedia.org/wiki/Transmission_Control_Protocol), which is an underlying protocol for how devices connect to one another on the internet. TCP is a network protocol, though, while SSB is a local protocol. This means it doesn't require any sort of internet connection to work.
	10 …	+
	11 …	+Patchwork,Patchbay, and Patchfoo are different applications used to interpret and display the various messages transmitted through SSB. A rough analogy would be that if SSB was like TCP, then an application like Patchwork would be like a web browser.
	12 …	+
	13 …	+A better analogy for all of this would be that Patchwork is a car you ride in and SecureScuttlebutt is the road you drive on. There are other types of cars that drive on the same road and you can drive a different car to the same place (car = application, road = protocol).
	14 …	+* With this analogy, the current car models for driving on ssb are:
	15 …	+ - Patchwork: family station wagon
	16 …	+ - Patchbay: pickup truck
	17 …	+ - Patchfoo: jeep
	18 …	+ - git-ssb: digger.
	19 …	+
	20 …	+----
	21 …	+Sources
	22 …	+* The answer is compiled from multiple posts from [this thread.](https://viewer.scuttlebot.io/%25m8%2B25i3i5LCRioA%2FCAqARVb0HNA6TTdvi4B0CxBd8eo%3D.sha256) Shoutout to @dominic for the car analogy.
	23 …	+

faq/basics/pub.mdView
		@@ -1,0 +1,18 @@
	1 …	+# What is a Pub?
	2 …	+
	3 …	+I joined patchwork, but it seemed really empty. Then I found out the best thing to do would be to join a pub. Are these like servers? Or people? Or drinking clubs?
	4 …	+
	5 …	+---
	6 …	+To best answer this question, we should first explain how Scuttlebutt is designed to work.
	7 …	+
	8 …	+Scuttlebutt works through word of mouth among your friend groups...literally. With Scuttlebutt, You write things in your diary and then, the next time you are near a friend, share what you've written. This friend then shares your diary entry with all their friends and soon all the awesome things you wrote has spread across your social network. This "gossiping" is simple to do if you are physically near a friend, since Scuttlebutt works with just a local router. If you cannot be physically near, and want to connect over the internet, it could be tremendously hard to find a direct connection to your friend across the vastness of all possible connections. That is where pubs come in to help.
	9 …	+
	10 …	+Pubs(named after real life pubs, or "public houses") are a peer you can follow that helps you catch up on the gossip and feed of your network. They act sort of as both bar and barfly, someone who never leaves the party and makes friends with everyone, and seems to always know the latest gossip. In (slightly) more technical terms, pubs are servers that have a static IP address, are always online, and always follow you back when you follow them (thus growing their network). In this way, they can act as a waypoint for you to find the location of your friends and catch up with them.
	11 …	+
	12 …	+When you first get started on Scuttlebutt it can appear incredibly empty until you "join" a pub. You can find a list of pubs to join [here](https://github.com/ssbc/scuttlebot/wiki/Pub-Servers). Though it is important to note that you aren't joining a server, you're more making a connection with a person that is also a place and is also neither. And metaphors are hard.
	13 …	+
	14 …	+This concept of pubs is one of the densest and most complex with Scuttlebutt. You can read more about it [here](https://www.scuttlebutt.nz/concepts/pub.html) and [here](https://www.scuttlebutt.nz/stories/design-challenge-avoid-centralization-and-singletons.html). Or just not worry about it too much right now and simply know: while pubs are not required to use scuttleverse they certainly make it simpler. Just like in real life, when you are new to the area, a pub is a great way to meet new friends.
	15 …	+
	16 …	+---
	17 …	+Sources
	18 …	+* [_Answer compiled mostly from this thread. Shoutouts to @mixmix for the original answer.](https://viewer.scuttlebot.io/%25lxUClUyoEVHQ0OIRq2uslFPcPJeJ2UmPROKdl996RFU%3D.sha256)

faq/basics/size.mdView
		@@ -1,0 +1,41 @@
	1 …	+# How much space will scuttlebutt take up on my computer?
	2 …	+
	3 …	+---
	4 …	+
	5 …	+This depends on how long you've been on scuttlebutt, how many friends you have, and how many high-quality kitten pics you send each other.
	6 …	+
	7 …	+Since you are holding the entire, evergrowing log of your friend network, it could grow rather large over time. The biggest storage space would be in your blobs folder, since that is holding all the attachments(kitten pics) sent to one another.
	8 …	+
	9 …	+For a better example of size, we can look at two users' .ssb folders: @keks and @cryptix.
	10 …	+
	11 …	+Here is @keks folder:
	12 …	+
	13 …	+ 2.5G ~/.ssb/blobs
	14 …	+ 7.5K ~/.ssb/blobs_push
	15 …	+ 512 ~/.ssb/config
	16 …	+ 125M ~/.ssb/db
	17 …	+ 272M ~/.ssb/fulltext0
	18 …	+ 512 ~/.ssb/gossip.json
	19 …	+ 20M ~/.ssb/links
	20 …	+ 1.5K ~/.ssb/manifest.json
	21 …	+ 122M ~/.ssb/media
	22 …	+ 60M ~/.ssb/node_modules
	23 …	+ 7.9M ~/.ssb/query
	24 …	+ 1.0K ~/.ssb/secret`
	25 …	+
	26 …	+And here is @cryptix's:
	27 …	+
	28 …	+ 32K ./blobs_push
	29 …	+ 9.5M ./query
	30 …	+ 28M ./links
	31 …	+ 172M ./node_modules
	32 …	+ 195M ./db
	33 …	+ 317M ./fulltext0
	34 …	+ 1.2G ./blobs
	35 …	+ 1.9G .
	36 …	+
	37 …	+In both cases, blobs take up significant space. If this is a concern, you can delete the blobs folder. Patchwork will fetch any blobs needed the next time you log on--assuming they still live in the folders of your friends. If you are the last person to have held onto the blob with the image of a cat falling asleep inside a cereal box, and then you delete that blob folder...that image is gone from the scuttleverse. All you have now are the memories (though let's be honest, you've probably saved that picture somewhere else cos it sounds incredible.)
	38 …	+
	39 …	+----
	40 …	+Sources
	41 …	+* Answer compiled from [this thread](https://viewer.scuttlebot.io/%25bUEQtn85jtL8Vxjup4sS%2F7wcaswS4fThUPVH7G5IvjU%3D.sha256) and [this thread](https://viewer.scuttlebot.io/%25Ayi7UUbJnIZ12S%2FgbHof60oHBlmjdrv7TUyFCq5cOTQ%3D.sha256) Shoutouts to @cryptix and @keks for awesome answers.

faq/channels/channel-find.mdView
		@@ -1,0 +1,11 @@
	1 …	+# How do I find a channel?
	2 …	+
	3 …	+And if it doesn't exist, how do I start it?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+If you are using Patchwork: You can click onto the search bar in the top right, type `#` then the channel name. If the channel does not yet exist within your friend network, then you can start it yourself!
	8 …	+
	9 …	+---
	10 …	+Sources
	11 …	+* Personal Experience!

faq/channels/channel-messages.mdView
		@@ -1,0 +1,14 @@
	1 …	+# How do channel subscriptions work?
	2 …	+
	3 …	+If I subscribe to a channel would I see messages from whoever wrote in that channel?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+You would see channel messages within your social network: so those of your friends and friends of friends. You would _not_ see messages from folks outside of your network, even though they may be posting something using the same channel designation.
	8 …	+
	9 …	+You _would_ see those messages if you later became friends (which is likely, since you share the same interests!)
	10 …	+
	11 …	+---
	12 …	+
	13 …	+Sources
	14 …	+* Answer taken from [this thread](https://viewer.scuttlebot.io/%256Jajc1TsINMv6%2FUMSEHThi0uTcHIbdluzyOVORsZkr8%3D.sha256)

faq/channels/channel-sort.mdView
		@@ -1,0 +1,17 @@
	1 …	+# How are channels sorted?
	2 …	+
	3 …	+They seem to be listed randomly when I search. Is there any rhyme or reason to this?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+There is!
	8 …	+
	9 …	+They are sorted by recent activity, favoring subscribed channels first.
	10 …	+
	11 …	+---
	12 …	+
	13 …	+Sources
	14 …	+
	15 …	+* Answer taken basically straight up from [this thread](https://viewer.scuttlebot.io/%25grj55XZxFnuMf%2BUqeQaZHC2RXRQcck%2FWzl1L1FeXP1o%3D.sha256). Shoutouts to @Alanna for asking and @Jeremy for answering!
	16 …	+
	17 …	+

faq/channels/channel-start.mdView
		@@ -1,0 +1,14 @@
	1 …	+---
	2 …	+related:
	3 …	+ - channels.md
	4 …	+ - channel-sort.md
	5 …	+ - channel-find.md
	6 …	+ - channel-start.md
	7 …	+---
	8 …	+
	9 …	+If you are using Patchwork: You can click onto the search bar in the top right, type `#` then the channel name. If the channel does not yet exist within your friend network, then you can start it yourself!
	10 …	+
	11 …	+---
	12 …	+
	13 …	+Sources
	14 …	+* Personal Experience!

faq/channels/channels-index.mdView
		@@ -1,0 +1,11 @@
	1 …	+# Channels
	2 …	+All the questions around the channels feature in the scuttleverse, and what it's meant to do.
	3 …	+
	4 …	+## Questions
	5 …	+
	6 …	+- [Can I use scuttlebutt on different devices, but maintain the same identity? (For example:updating my Patchwork feed from my home or work computer?)](multiple-devices.md)
	7 …	+- [What are channels and how do they work?](channels.md)
	8 …	+- [Are Channels sorted in any order?](channel-sort.md)
	9 …	+- [If I subscribe to a channel would I see messages from whoever wrote in that channel?](channel-messages.md)
	10 …	+- [How do I find a channel?](channel-find.md)
	11 …	+- [How do I start a channel?](channel-start.md)

faq/channels/channels.mdView
		@@ -1,0 +1,18 @@
	1 …	+# What Are channels?
	2 …	+
	3 …	+And also: how do they work?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+Channels are a way to organize your messages and conversations, but offer no additional functionality (that's not already part of scuttlebutt).
	8 …	+
	9 …	+ Subscribing to a channel will let you read messages from your friends (and friends of friends) who have written in this channel. You will not, however, see any channel messages from folks not in your network. You do not need to subscribe to a channel to see a message a friend posts to it. You will see it on your main feed simply cos they're a friend and you're interested, on a technical(and emotional!) level, in what they have to say.
	10 …	+
	11 …	+An analogy! If scuttlebutt works as a big diary--with each message you post added to the end of your diary and shared with your friends-- then channels are like writing a diary entry with a different colored pen. They are simply a pleasing, personal form of organization. But luckily your friends follow this same technique and use the same pens and so you can easily share your related messages.
	12 …	+
	13 …	+There has been discussion on whether channels should work more like hashtags, and to have a distinct "group" feature that would behave closer to a slack channel or discussion group. You can read more of that conversation [here](https://viewer.scuttlebot.io/%25gTHLf3Rlc48RSjwATVDJZpe9VlWGfxMmio1%2Bo3KXvjA%3D.sha256)
	14 …	+
	15 …	+---
	16 …	+Sources
	17 …	+* Answer compiled from multiple posts on [this thread](https://viewer.scuttlebot.io/%256Jajc1TsINMv6%2FUMSEHThi0uTcHIbdluzyOVORsZkr8%3D.sha256) Shoutouts to @kas, @dinosaur, and @dominic for the help!
	18 …	+

faq/index.mdView
		@@ -1,0 +1,21 @@
	1 …	+* [ Basics](basics/basics.md)
	2 …	+ - [What is Patchwork and Scuttlebutt?](basics/patchwork-vs-scuttlebutt.md)
	3 …	+ - [What is a pub?](basics/pub.md)
	4 …	+ - [Scuttlebutt works through gossip?](basics/gossip.md)
	5 …	+ - [Where does all my data live?](basics/data-live.md)
	6 …	+ - [How much space will Scuttlebutt use?](basics/size.md)
	7 …	+ - [What happens if I delete everything?](basics/delete.md)
	8 …	+* [Applications](applications/applications.md)
	9 …	+ - [How do posts work across apps?](applications/patchwork-and-patchbay.md)
	10 …	+ - [Can I switch apps easily?](applications/moving-ssb-apps.md)
	11 …	+ - [Can I post from different devices?](applications/multiple-devices.md)
	12 …	+* [Channels](channels/channels-index.md)
	13 …	+ - [What are channels?](channels/channels.md)
	14 …	+ - [Are Channels sorted in any order?](channels/channel-sort.md)
	15 …	+ - [How do channel descriptions work?](channels/channel-messages.md)
	16 …	+ - [How do I find a channel?](channels/channel-find.md)
	17 …	+* [Misc](misc/concepts.md)
	18 …	+ - [What are some good resources?](misc/resources.md)
	19 …	+ - [This seems really cool?](misc/cool.md)
	20 …	+ - [Who wrote this FAQ?](misc/faq-credits.md)
	21 …	+ - [How can I help?](misc/help.md)

faq/misc/concepts.mdView
		@@ -1,0 +1,8 @@
	1 …	+# Concepts
	2 …	+Miscellaneous questions around the _ideas_ behind Scuttlebutt and the scuttleverse. Also questions around the FAQ itself.
	3 …	+
	4 …	+## Questions
	5 …	+- [Are there any good resources about the origins of Scuttlebutt?](resources.md)
	6 …	+- [All of this seems really cool?](cool.md)
	7 …	+- [Who is writing this FAQ?](faq-credits.md)
	8 …	+- [How can I help?](help.md)

faq/misc/cool.mdView
		@@ -1,0 +1,5 @@
	1 …	+# This seems really cool?
	2 …	+
	3 …	+---
	4 …	+
	5 …	+It is really cool!

faq/misc/faq-credits.mdView
		@@ -1,0 +1,14 @@
	1 …	+# Who wrote this FAQ?
	2 …	+
	3 …	+And where are they getting their answers?
	4 …	+
	5 …	+---
	6 …	+
	7 …	+This FAQ was originally started by Zach. He was helped by his entire scuttle network. Much of the responses were taken from replies on scuttlebutt and have been credited as such in the source section of the answers.
	8 …	+
	9 …	+The FAQ, ideally, will have many contributors. One of the contributors could be you, and so it's fair to say this FAQ was probably also written by future you.
	10 …	+
	11 …	+---
	12 …	+
	13 …	+Sources
	14 …	+* You and me. Us!

faq/misc/help.mdView
		@@ -1,0 +1,20 @@
	1 …	+# How can I help?
	2 …	+
	3 …	+I want to get involved with this FAQ because I am awesome!
	4 …	+
	5 …	+---
	6 …	+
	7 …	+You can help with the FAQ by asking a question, refining one of my answers, or submitting an entire question and answer.
	8 …	+
	9 …	+I am using gitbook to assemble this all, and so to help with any of the above simply submit a change request on the gitbook page, found [here](https://www.gitbook.com/book/nelsonian/ssb-faq/edit#/edit/master/README.md?_k=4k2qxt)
	10 …	+
	11 …	+If that does not work, you can reach me through scuttlebutt. My scuttlename is @ZqH7Mctu/7DNInxuwl12ECjfrAKUX2tBLq1rOldNhg0=.ed25519. (caveat: searching by this will only work if we are in the same friend network. But we prolly are. I'm pretty social and this place is still small.)
	12 …	+
	13 …	+I love any help you want to give, with one caveat: This FAQ is intended as a sort of "on-ramp" to the scuttleverse, and so meant to be simple. I would love to have links to deeper and more technical resources, but this should not be seen as a FAQ for the highly technical stuff (so no questions about how to make an SSB app with just tin cans, a hacked talkboy, and a cursory knowledge of LISP.)
	14 …	+(Though as I write this I realize that answer would be super cool and so I urge you to start up an advanced FAQ if you're able.)
	15 …	+
	16 …	+---
	17 …	+
	18 …	+Sources
	19 …	+
	20 …	+* My heart's wants.

faq/misc/resources.mdView
		@@ -1,0 +1,12 @@
	1 …	+# What are some good resources?
	2 …	+
	3 …	+I want to learn more about the history of scuttlebutt, and the concepts that are beneath it.
	4 …	+
	5 …	+---
	6 …	+
	7 …	+[Scuttlebutt.nz](http://scuttlebutt.nz) has some fantastic resources for this. I would recommend the sections [Talks](https://www.scuttlebutt.nz/talks.html), [Concepts](https://www.scuttlebutt.nz/concepts/), and [Stories](https://www.scuttlebutt.nz/stories/)
	8 …	+
	9 …	+---
	10 …	+Sources
	11 …	+
	12 …	+* My honest, personal opinion

Built with git-ssb-web

mixmix / ssb-handbook

Commit af3a8cfa08969dc0aedf26281692d849edfec3af

Merge branch 'adding-faq'

Files changed