git ssb - Fill out the Repo with Sketches · Zach!/non-dev-resources@0e093f8a

Commit 0e093f8a99310fc4a8f30de0c990d3a03e17ef25

Fill out the Repo with Sketches

Zach committed on 11/16/2017, 11:59:48 PM
Parent: 072fbac168311b4af734942b01ee27eafde62e9a

Files changed

LICENSE	changed mode from 100644 to 100755
README.md	changed mode from 100644 to 100755
how-to-throw-an-ssb-party.md	added
markdown-style-guide.md	added
onboarding-animation	added
onboarding-animation.md	added
personas.md	added
scuttlebuttnz-revamp/README.md	added
ssb-comparisons.md	added
ssb-in-context/facebook-tutorial.md	added
ssb-in-context/twitter-tutorial.md	added
ssb-intro-video.md	added
tips-for-getting-started.md	added
what-is-solarpunk.md	added

LICENSEView
		@@ -630,10 +630,10 @@
630	630 …	to attach them to the start of each source file to most effectively
631	631 …	state the exclusion of warranty; and each file should have at least
632	632 …	the "copyright" line and a pointer to where the full notice is found.
633	633 …
634		- <one line to give the program's name and a brief idea of what it does.>
635		- Copyright (C) <year> <name of author>
	634 …	+ {one line to give the program's name and a brief idea of what it does.}
	635 …	+ Copyright (C) {year} {name of author}
636	636 …
637	637 …	This program is free software: you can redistribute it and/or modify
638	638 …	it under the terms of the GNU General Public License as published by
639	639 …	the Free Software Foundation, either version 3 of the License, or
		@@ -651,9 +651,9 @@
651	651 …
652	652 …	If the program does terminal interaction, make it output a short
653	653 …	notice like this when it starts in an interactive mode:
654	654 …
655		- <program> Copyright (C) <year> <name of author>
	655 …	+ {project} Copyright (C) {year} {fullname}
656	656 …	This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657	657 …	This is free software, and you are welcome to redistribute it
658	658 …	under certain conditions; type `show c' for details.
659	659 …

README.mdView
		@@ -1,2 +1,117 @@
1		-# ssb-non-dev-resources
2		-Resources for SSB(Secure Scuttlebutt) that are intended for the discerning, non-technical visitor.
	1 …	+## Proposal for Scuttlebutt Resources for the non-technically minded.
	2 …	+
	3 …	+[Part of our SSB Revamp Vision](README.md)
	4 …	+
	5 …	+# Goal
	6 …	+
	7 …	+This project will develop a set of resources that articulate the spirit of Scuttlebutt and all its
	8 …	+awesome potential, but targeted to people who are not developers or technological hobbyists. With
	9 …	+these resources, our network is accessible to a larger group-- who can get onboarded and active
	10 …	+without needing to understand github, node dependencies, or the malleable and nuanced definition of
	11 …	+a pub.
	12 …	+
	13 …	+These resources would proudly display our existing, beautiful solarpunk weirdness, so people are
	14 …	+drawn to the culture of this community as much as to the promise of its tech.
	15 …	+
	16 …	+# How it Will Work
	17 …	+
	18 …	+We create a set of videos, articles, and other illustrative materials that succintly articulate what
	19 …	+scuttlebutt is, why it's unique, and why someone would want to join. We would also create an
	20 …	+equally rich set of materials that help people once they've joined, to help them make sense of the
	21 …	+space and quickly feel at home. These resources would all live on scuttlebutt.nz, in a revamped
	22 …	+homepage. In this way, there's a simple link a SSB-er can give to friends interested in this
	23 …	+'verse, but offer an entrance that isn't overwhelming with tech docs.
	24 …	+
	25 …	+While the resources would work together to give a nuanced, helpful introduction to our 'verse; they
	26 …	+would also be designed to work on their own and without any context. In this way, each piece could
	27 …	+be shared through the old internet's existing channels as interesting standalone pieces, but they
	28 …	+would lead people to scuttlebutt.nz and all the other riches to be found there.
	29 …	+
	30 …	+# Who These Resources are Meant for
	31 …	+
	32 …	+There's millions of people with computers who quality as "non-technically minded". I do not think
	33 …	+we should try to make materials that would speak to any of these millions. Instead, we should focus
	34 …	+on the types of non-technical people we'd love to have in our community now, and focus our language
	35 …	+to them. This aims for a slower, more organic growth that builds upon our awesome, emerging
	36 …	+culture.
	37 …	+
	38 …	+I've written up a list of personas that I think fit the type of people we should direct our efforts
	39 …	+to. It can be found here: [Personas](personas.md)
	40 …	+
	41 …	+If you think there is someone missing from that list, please feel free to make a pull request!
	42 …	+
	43 …	+# Index of these Resources
	44 …	+
	45 …	+*Click the link to travel to this resource's page within the REPO. Each one is is various states of
	46 …	+"done-ness"*
	47 …	+
	48 …	+### [Introduction to Scuttlebutt in Less than 3 Minutes](ssb-intro-video.md)
	49 …	+
	50 …	+A 30 second to 1 minute video that enthuses upon the core values, concepts, and awesome things of
	51 …	+Scuttlebutt. It's intent is to invite folks to learn more within the site (or by travelling to the
	52 …	+site, if they see the video on some other network). For that reason, it is less concerned with
	53 …	+exactness than with spirit, and is the most 'markety' of our resources.
	54 …	+
	55 …	+### [Revised Landing Page for Scuttlebutt.nz](scuttlebuttnz-revamp/README.md)
	56 …	+
	57 …	+A simpler homepage for scuttlebutt that succintly explains the spirit of our community, and offers
	58 …	+an entrance to both dev and non dev resources. The page is designed for better navigation and
	59 …	+keener cultural aesthetics.
	60 …	+
	61 …	+### [Simple Animation Explaining what to Expect when you first join
	62 …	+Patchwork](onboarding-animation.md)
	63 …	+
	64 …	+A quick and simple addition to our homepage that shows, in handy GIF form, what is going to happen
	65 …	+once Patchwork is done installing and you join SSB.e
	66 …	+
	67 …	+
	68 …	+### [Understanding SSB in Context, by Understanding, Conceptually, how Centralized Systems
	69 …	+Work](ssb-in-context/README.md)
	70 …	+
	71 …	+A series of articles/resources that explain how simple functions like sending messages or posting
	72 …	+statuses happen within centralized models. These articles detail the overlooked technical
	73 …	+processes, and business diescions, required in a centralized system. Through this context, a user
	74 …	+can better understand what makes SSB different and why it's important.
	75 …	+
	76 …	+Individual Resources:
	77 …	+
	78 …	+[Understanding Centralized Models: How to Send a Message to your Grandma On Facebook: A Step by Step
	79 …	+Guide](ssb-in-context/facebook-tutorial.md)
	80 …	+
	81 …	+[Understanding Centralized Models: How to Post an Effective
	82 …	+Tweet](ssb-in-context/twitter-tutorial.md)
	83 …	+
	84 …	+### [How to Throw an SSB Party](how-to-throw-an-ssb-party.md)
	85 …	+
	86 …	+A friendly guide for the current Scuttlebutt member who wants to invite their friends onto the
	87 …	+'verse. It details the best ways to onboard folks when in the same room and on the same network. it
	88 …	+also details the best ways to throw a super good party.
	89 …	+
	90 …	+### [Markdown Style Guide](markdown-style-guide.md)
	91 …	+
	92 …	+An easy-to-miss stumbling block for our clients is not knowing how to properly write messages in
	93 …	+them. Markdown is common in tech, but not as common outside of it. Producing an ssb- specific
	94 …	+markdown style guide, that can be incorporated into our clients, would help people confidently post.
	95 …	+
	96 …	+### [SSB Compared to other Clients/Networks](ssb-comparisons.md)
	97 …	+
	98 …	+SSB is it's own beautiful thing, which means it's kinda like (but not quite like) a bunch of other
	99 …	+things. This small guide compares SSB and its current clients to other well-known
	100 …	+messaging/socializing platforms. This way someone can have the right context for what to expect(and
	101 …	+get excited about) in SSB.
	102 …	+
	103 …	+### [What is Solarpunk?](what-is-solarpunk.md)
	104 …	+
	105 …	+This identification has gained an incredible life within the scuttleverse, and it is a relatively
	106 …	+new genre/marker within the larger world. This article outlines how we define solarpunk and how
	107 …	+it's expressed within the network (from Spider-Farm to Dominic coding ssb on a solar-powered
	108 …	+computer to our practical discussions of airship manufacturing and governance without oppression)
	109 …	+
	110 …	+### [Tips for Getting Started](tips-for-getting-started.md)
	111 …	+
	112 …	+This would be a video/article about how to post, and what to post. How to
	113 …	+subscribe to a channel, and what a channel means. The difference between public and private posts,
	114 …	+Some popular topics to check out, and other encouragement to help new folks express their unique
	115 …	+selves within our unique 'verse.
	116 …	+
	117 …	+

how-to-throw-an-ssb-party.mdView
		@@ -1,0 +1,11 @@
	1 …	+# How to Throw an SSB Party
	2 …	+
	3 …	+Objective
	4 …	+
	5 …	+This article is intended for SSB members who want to get more of their friends onto the 'verse. One of the best ways to onboard friends is to be on the same network as them, and showing how SSB works within the local network.
	6 …	+
	7 …	+This article, then, describes the best way to get your friends together and successfully using scuttlebutt. The article is written somewhat in the style of a Martha Stewart Living Article. It's focus is on you being a great party host _as well as_ getting folks onto SSB. The humor is in the goofy enthusiasm the author of the post is putting into this party, and what ridiculous things are needed for it to be a success (hand-made invitations. Homemade fortune cookies that contain within the password to your wifi. A specific Scuttlebutt playlist you play, etc.)
	8 …	+
	9 …	+While the article woudl be goofy, there is still useful information prominent throughout. For example, not only getting everyone on the same WIFI but also detailing which ports SSB uses so that if someone can't see everyone else, you can check their firewall and help them get through. It would also recommend sort of "etiquette" tips (choosing names for everyone, but not being an ss about it, for example).
	10 …	+
	11 …	+

markdown-style-guide.mdView
		@@ -1,0 +1,21 @@
	1 …	+# Markdown Style Guide
	2 …	+
	3 …	+Objective
	4 …	+
	5 …	+Offer a standard guide to how to write in markdown, but with the examples using lightly silly and lightly solarpunk examples.
	6 …	+
	7 …	+eg.
	8 …	+`I want to __accentuate__ how much I love this post about AIRSHIPS`
	9 …	+
	10 …	+```
	11 …	+Here is my list of why Frasier is the best TV Show:
	12 …	+ 1. points that are an ordered list.
	13 …	+ 2. likely about how great Roz is.
	14 …	+ 3. Go into the finer points of finer points
	15 …	+ * Using an undordered list
	16 …	+ *to truly show the point
	17 …	+```
	18 …	+
	19 …	+Basically, make it so the style guide doesn't feel like reading a legal document.
	20 …	+
	21 …	+It would also include ssb specific tips, like what it looks like when you reference another thread, how to attach images, how to link to git-ssb repos (or files within those repos) and how to post to different channels.

onboarding-animationView

onboarding-animation.mdView
		@@ -1,0 +1,14 @@
	1 …	+# Onboarding Animation
	2 …	+
	3 …	+Objective
	4 …	+
	5 …	+Simple, step-by-step, explanation of what will happen once you start up Patchwork and get going. It is intended to live at the top of the revamped homepage, and get people into our 'verse as soon as possible.
	6 …	+
	7 …	+Steps:
	8 …	+- Find Patchwork in your Applications (explaining it's an app and not a site)
	9 …	+- Give yourself a name and description (choose whatever you want!)
	10 …	+- Click Join a Pub and put in an invite code (explain what a pub is and isn't, and offer a simple invite code within these steps for them to copy and paste)
	11 …	+- Messages will start downloading. This will take about 5 minutes.
	12 …	+- Your are downloading your network onto your computer, essentially. Be clear with how much space this will likely take, and why.
	13 …	+- Post in #new-People and check otu these other channels! (#cooking-channel, #solarpunk, #offgrid, #feminism, #comics, #past)
	14 …	+- Best thing to do is just state what it is you'd love to talk about. you'll find some other fan.

personas.mdView
		@@ -1,0 +1,108 @@
	1 …	+## Personas
	2 …	+
	3 …	+# Introduction
	4 …	+
	5 …	+Our non-dev resources will be the most successful, and cohesive, if we design them for a specific
	6 …	+audience. SSB is not built for universal adoption, at least right now. So instead, I'd like to
	7 …	+design our outreach to target the people we'd want to join the system at its current stage. As the
	8 …	+system grows, we can make more resources for the broader audiences.
	9 …	+
	10 …	+By targeting a certain kind of audience, we can build a stronger voice for our work. If we tried to
	11 …	+find the words that resonate with all people, or put in all the necessary additional context for any
	12 …	+set of knowledge, then we would water down the videos with good intentions until the actual message
	13 …	+is dissolved from view.
	14 …	+
	15 …	+This document is meant to describe the Personas of people who would make good community members now,
	16 …	+_and_ who do not identify as technically minded. They are not meant as rigid identifiers; any one
	17 …	+person will undoubtedly share traits from multiple personas. But they act as a useful shorthand, and
	18 …	+are illuminating for the traits and types that _don't_ show up here.
	19 …	+
	20 …	+Nerdy, but not Technical
	21 …	+- Fan of science fiction, diy music, overlooked films, independent comics. Has diverse tastes, but
	22 …	+ they share a bond of being proudly off the beaten path. Champions the quieter voices, and not
	23 …	+ liking something _just_ because everyone says you should.
	24 …	+- Social Media is getting boring as it all feels like the same conversation and all depressingly
	25 …	+ mainstream.
	26 …	+- Listened to a great podcast episode about cryptocurrencies, and is thinking of getting into
	27 …	+ bitcoin, but didn't really know how to start. The podcast brought up really interesting points
	28 …	+ about what the future could look like though, and enjoys talking about some of these future
	29 …	+ visions.
	30 …	+- Would like to code, can see how it's an art, but "was never good at math" and so don't think they
	31 …	+ could do it. But they love programs that makes it feel like they're hacking (torrenting, VLC,
	32 …	+ minimal writing programs)
	33 …	+
	34 …	+Friend/Family Member Who was Told to Check this Out
	35 …	+
	36 …	+- Was at a gathering where someone they trusted started gushing about Scuttlebutt. Was given a link
	37 …	+ to scuttlebutt.nz to learn more, and decided on a whim to check it out.
	38 …	+- Don't necessarily need to know how it all works, or why they would want to use it. They've
	39 …	+ already decided to try it for the main reason that their family is on it.
	40 …	+- Understanding how to get on and send a message to their loved one simply will be important. And
	41 …	+ some basic navigation of the system.
	42 …	+- At the same time, they may appreciate reading more of the context and history of this system. If
	43 …	+ they are wanting to get onto this weird system to connect with their loved one, they likely are
	44 …	+ also into being able to talk about this thing their lvoed one is into. Providing accessible
	45 …	+ guides into basic internet theory and the decisions behind Scuttlebutt could help.
	46 …	+
	47 …	+Solarpunk looking for a home
	48 …	+- Solarpunk is a rising genre that self-describes its origins as a tumblr post. For many Solarpunk
	49 …	+ fans, it is right now more of an _idea_ for a thing than a thing itself. Solarpunk describes an
	50 …	+ optimistic future where humans live in better harmony with nature and with one another through the
	51 …	+ smart use of technology.
	52 …	+- An aspect of solarpunk fandom is sharing real life solarpunk places. Eco-villages in Singapore or
	53 …	+ the Arcosanti in Arizona. They also like new technologies that seem to point towards this
	54 …	+ Solarpunk future.
	55 …	+- Scuttlebutt _is actually_ Solarpunk, in all major senses of the word. It is a protocol written on
	56 …	+ solar power, and a community filled with people living solarpunk lives.
	57 …	+- It can act as a community for folks tired of looking at tumblr art and wanting something else, or
	58 …	+ who had just read an awesome brazilian solarpunk sci-fi and seeing what other things within this
	59 …	+ genre they can find.
	60 …	+- This persona is looking for a solarpunk, off-grid community and through that finds solarpunk,
	61 …	+ off-grid technology.
	62 …	+
	63 …	+Nice Person who is unsafe on standard social media
	64 …	+- A marginalized person who faces regular harrassment, stalking, personal attacks, and physical
	65 …	+ threats online. Through this has become rightfully exhausted and wary of social media.
	66 …	+- Their experience online likely reflects a similar, and potentially more dangerous, experience in
	67 …	+ the greater world. Because of this, safe community is a necessary survival tool.
	68 …	+- Knows that underlying technical structures within the standard social media engenders and powers
	69 …	+ abuse, and perhaps has been vocal to the developers of these sites about it. Or has built ways
	70 …	+ within the sites to help counteract these structural hazards. This work is exhausting though, and
	71 …	+ can make one feel powerless. And has begun to look for alternate online platforms for
	72 …	+ communities.
	73 …	+- Because caution is also a necessary survival tool, will likely find scuttlebutt through word of
	74 …	+ mouth from within their community. Will then want to get onto the system simply, find their home
	75 …	+ quickly, and know they have the tools for safety.
	76 …	+- (I am saying 'nice person' to mean "not a hateful, fascist, transphobic, racist, sexist asshole".
	77 …	+ The latter person may also feel unsafe on standard social media, and look for alternate models.
	78 …	+ I would want these folks to know they are not welcome in our community, without signalling our
	79 …	+ community as a place to attack.)
	80 …	+
	81 …	+Artist looking for a Platform, burnt out on Social Media
	82 …	+- the degrading and devaluing aspects of social media has wrecked this person, and made doing their
	83 …	+ art feel unfun. At the same time, knows that social media nd self-promotion is a necessary evil
	84 …	+ of the modern day.
	85 …	+- Is curious about other models, and perhaps new platforms where they can still share the thigns
	86 …	+ they've made without feeling massively depressed afterwards.
	87 …	+- Will be looking for a receptive audience, but may not have defined what that means yet. Will also
	88 …	+ be looking for a supportive community of other artists.
	89 …	+- Fully understand the effects that social media has on culture, but is not available to build up
	90 …	+ the new tools themselves. But knows awesome ways to make the most of their tools.
	91 …	+- In many cases, reaching this persona will require new clients (ones that are more visual focused,
	92 …	+ for example, or have music sharing and streaming as part of it)
	93 …	+
	94 …	+Snowden is a Patriot. Are you on Signal?
	95 …	+- Is aware of the terrible privacy issues and security issues of the world today, and the
	96 …	+ frightening power large companies have on us--as well as the creeping power of the gov't through
	97 …	+ increased surveillance.
	98 …	+- Is aware of this on a broad level, but may not understand the best way to respond. Knows of the
	99 …	+ existence of TOR, but thinks of it as a place to buy drugs only. May talk of how cool it'd be to
	100 …	+ have an onion site, but no knowledge of how tos tart it.
	101 …	+- Has security concerns, and wishes to have better words to express them and tools to fight them.
	102 …	+ Will be drawn to SSB because of it seeming privacy, the end to end encryption, and as a potential
	103 …	+ new way to talk to friends securely.
	104 …	+- Will want to host a pub right away, and also ask why pubs are needed. Will be asking technical
	105 …	+ questions about the broad security model mostly because they are excited that this may be the
	106 …	+ thing they'd been looking for (but don't fully understand what this thing is)
	107 …	+
	108 …	+

scuttlebuttnz-revamp/README.mdView
		@@ -1,0 +1,85 @@
	1 …	+# Scuttlebutt: The Social Network of the Future, Available Today
	2 …	+
	3 …	+# Summary
	4 …	+
	5 …	+This page is devoted to the revamping of the Scuttlebutt.nz page, and general promotion/onboarding
	6 …	+of Scuttlebutt. Our method is to set distinct goals for scuttlebutt.nz, then outline new content or
	7 …	+design revisions that can help achieve these goals. The repo in which this lives holds the fruits
	8 …	+of this work for us and gives us a place to collaborate upon imrpoving htis work.
	9 …	+
	10 …	+And So!
	11 …	+
	12 …	+
	13 …	+# Goals
	14 …	+
	15 …	+1. Scuttlebutt.nz is the most accessible entrypoint for people curious about the wonders of
	16 …	+ Scuttlebutt. It's design and content, then, should be as accessible and wonder-filled to as many
	17 …	+ types of people as possible.
	18 …	+
	19 …	+2. An incredible culture is forming within the scuttleverse. It is supported by the technical layer
	20 …	+ (in a way unprecedented in a social network), but driven intentionally by the people in the
	21 …	+ 'verse. This culture describes an alternative to oppressive, unjust systems in society, along
	22 …	+ with an antidote to the depressed, competitive panic of standard social media. Scuttlebutt.nz is
	23 …	+ a great vehicle to broadcast this culture to people who are seeking something different, but did
	24 …	+ not know how to articulate it.
	25 …	+
	26 …	+3. We have a ridiculous amount of talented developers and technologists who understand the potential
	27 …	+ of Scuttlebutt, and want to help build this future, but are unsure where to start. They are
	28 …	+ desiring more technical specs and documentation for how to build in this space. Scuttlebutt.nz
	29 …	+ can be the basecamp for these adventurers.
	30 …	+
	31 …	+# My Vision, In Short
	32 …	+
	33 …	+We create a classic landing page for scuttlebutt.nz that presents the idea of SSB in as simple and
	34 …	+elegant of a way as possible. We remove any auxillary/unnecessary information from this page, and
	35 …	+remove any formatting that could overwhelm or confuse non-technical vistors. Then, the landing
	36 …	+page would display two entrypoints into the larger ssb-handbook: One for people curious about a new
	37 …	+social network, and one for people eager to build upon this network.
	38 …	+
	39 …	+For those non-technical but curious:
	40 …	+
	41 …	+We create resources that communicate the spirit and excitement of SSB without technical terms
	42 …	+Additionally, we make resources that illustrate why this technical stuff is important (i.e. why
	43 …	+decentralized matters, and what exactly it means for something to be centralized). We also proudly
	44 …	+lean into the culture that's growing here, and use this as defining elements in our content. We do
	45 …	+not try to present SSB as a network that works for all people. We present it as radical and lovely
	46 …	+and strange as it actually is, and set our audience to be folks looking for this type of place.
	47 …	+
	48 …	+For the technical-minded:
	49 …	+
	50 …	+we flesh out the documentation for how all of this works, with tutorials for entry points into
	51 …	+development (how to set up your git-ssb repo, how to set up your own pub, how to build a simple
	52 …	+module for patchbay, etc.). We consolidate the blog posts and documentation already scattered
	53 …	+around the scuttleverse and (with permission) republish it on this central homepage.
	54 …	+
	55 …	+Lastly, we research how the internet and social media is used by different communities/users today,
	56 …	+and document this research. If we want to appeal to artists and generl non-devs, then we should
	57 …	+understand more what their life is like now, and build up a body of research around how people
	58 …	+interact with the online, and what makes them exhausted and depressed and looking for something
	59 …	+else. With these interviews and studies, we can better build applications that answer the needs of
	60 …	+these communities and build instructional content that speaks to their heart.
	61 …	+
	62 …	+# My Vision, In List Form
	63 …	+
	64 …	+1. Build a new landing page for Scuttlebutt that elegantly introduces the concept of SSB then offers
	65 …	+ two paths to learn more: one for people who want to join this community, and one for people who
	66 …	+ want to build for this community.
	67 …	+
	68 …	+2. [Develop stronger, and more accessible, content](non-dev-resources.md) for the non-dev, non-techie identifying folks who
	69 …	+ want to join this community.
	70 …	+
	71 …	+3. Consolidate our current tech documentation and then flesh it out and make it more accessible to
	72 …	+ techie-identifying folks who want to build out the network more.
	73 …	+
	74 …	+4. Build up a body of research into the lives and needs of different groups of people: artists,
	75 …	+ musicians, scene-supporters, fans, to see how they exist online today, and what their dream of
	76 …	+ a connected future would be. Use this research to build out our clients and protocols to better
	77 …	+ answer the needs of these communities, and to write up content that better speaks to these peer
	78 …	+ types.
	79 …	+
	80 …	+# Individual Branches of this Work
	81 …	+
	82 …	+1. New Landing Page Design(todo)
	83 …	+[2. Non-Dev Resources](/non-dev-resources.md)
	84 …	+3. Dev Resources(todo)
	85 …	+4. Research into Communities(todo)

ssb-comparisons.mdView
		@@ -1,0 +1,15 @@
	1 …	+# SSB Comparisons
	2 …	+
	3 …	+Objective
	4 …	+
	5 …	+Compare SSB to other popular messaging and social networking clients. It is not intended as a "HERE'S HOW WE BLOW THEM OUTTA THE WATER!" (though our qualities will be apparent). It's meant as a helpful way for a new person to get some context on what they can expect to get out of SSB at this time.
	6 …	+
	7 …	+Clients to compare to:
	8 …	+- Slack
	9 …	+- Signal
	10 …	+- Mastodon
	11 …	+- Facebook
	12 …	+- Twitter
	13 …	+- Email(?)
	14 …	+- Medium(?)
	15 …	+

ssb-in-context/facebook-tutorial.mdView
		@@ -1,0 +1,283 @@
	1 …	+## Centralization vs. Decentralization: Facebook Example
	2 …	+
	3 …	+# Introduction
	4 …	+
	5 …	+A core aspect of Scuttlebutt is that we are decentralized, meaning we don't rely on any central
	6 …	+server. This aspect is deeply important to our community, as we believe decentralized systems will
	7 …	+help bring a more optimistic and equal future. This aspect also makes Scuttlebutt markedly
	8 …	+different from the internet, as most sites and services there are centralized.
	9 …	+
	10 …	+This centralized design is not obvious. Web developers want their sites to be simple and
	11 …	+accessible, so the technical processes that power them are hidden in the background. But the
	12 …	+technical side has a profound affect on what is and is not possible online, as well as the level of
	13 …	+influence these sites have upon your general life.
	14 …	+
	15 …	+To better understand what makes Scuttlebutt different, it's good to know how exactly a centralized
	16 …	+system works. So let's take a look at how something simple, like sending a personal message, works
	17 …	+with a centralized model. Specifically, let's take a look at how it'd work on Facebook. And to be
	18 …	+even more specific, let's say it’s a message to your grandma.
	19 …	+
	20 …	+A quick note: There's an absurd amount that happens behind the scenes when you do anything online,
	21 …	+more than I could cover in a 10 minute read. This article is meant to explain the fundamental
	22 …	+essence of a centralized site, and so some complexities are simplified into their basic conceptual
	23 …	+model. It’s sorta like how the phrase "It’s raining outside" should not be considered a definitive
	24 …	+description of weather, but still gets a necessary point across.
	25 …	+
	26 …	+And so, let’s get to the point!
	27 …	+
	28 …	+
	29 …	+How to Send a Facebook Message to your Grandma: a Step-by-Step Guide
	30 …	+
	31 …	+The Setup: It's a Thursday afternoon, and you realize you haven't talked to your grandma in
	32 …	+a while. You know your grandma's bookclub meets on Wednesdays, and so you come up with the
	33 …	+(incredible) idea of sending her the message: "Hey Grandma, how are you! How was book club
	34 …	+yesterday?"
	35 …	+
	36 …	+*You open up your computer and head to www.facebook.com**
	37 …	+
	38 …	+-At this moment, the first key technical process occurs. Which is that your computer requests some
	39 …	+information from the server that holds Facebook. The words 'facebook.com' are an address for where,
	40 …	+within the vast network of the internet, this server broadcasts itself, but the server is actually
	41 …	+a physical _thing_ living somewhere in the real world. Since Facebook (the site) is huge , it's
	42 …	+server must be huge too-- rows upon stacks upon rows of simultaneously running computers, all housed
	43 …	+in a giant warehouse situated in the middle of nowhere so Facebook can save on real estate costs.
	44 …	+This warehouse will likely be near some natural body of water, like a river. The server is
	45 …	+receiving, storing, and sending everyone’s messages at once, which causes it to get get _hot_. By
	46 …	+diverting water from the river, Facebook has a natural, inexpensive coolant, a grand version of the
	47 …	+icepack you place beneath your computer when you want to watch a movie and use photoshop at the same
	48 …	+time.
	49 …	+
	50 …	+When you access Facebook on the browser, your computer sends a request to this idyllic riverside
	51 …	+monolith, which responds by showing you the data on its server it would like you to see. In this
	52 …	+case, it's the homepage. Because the internet is awesome and powerful, this transaction happens
	53 …	+near instantaneously. But what's important to remember is that your computer is _viewing_ the data
	54 …	+that makes up the site, but it is not holding it. All of it is still living on the distant server.
	55 …	+It's like when you video chat with someone: you can see their nice face and messy room, but their
	56 …	+face and room are not alive inside your computer. When you go onto their site, Facebook lets you
	57 …	+view your photos, friends, memories, and posts, without you holding any of them yourself.
	58 …	+
	59 …	+You log into your FB account
	60 …	+
	61 …	+The server holds all the data about Facebook; not just your Facebook, the entirety of the site from
	62 …	+back when it was `thefacebook`. To make managing their data easier, FB will optimize how it's
	63 …	+stored, how it's organized, and how the server should access it. But this efficiency is designed to
	64 …	+help computers and servers, and so the information that makes up facebook, when viewed as just data
	65 …	+on a hard drive, would likely make very little sense to you. There would not be a folder called
	66 …	+"You!" that held all your stuff, and placed neatly beside folders called "Your Friend!" and "Your
	67 …	+Grandma!". Instead, the entire site is a folded up, byzantine jumble of efficiency. -
	68 …	+
	69 …	+Facebook creates _the illusion_ of order through the metaphor of a user account. User accounts give
	70 …	+filtered views into the data, so you only see things relevant to you. To ensure your unique view
	71 …	+cannot be seen by other users, they let you assign your username a password, so your partitioned
	72 …	+view is specific to a login (or at least to whomever knows your login). This information about
	73 …	+usernames and passwords _also_ lives on Facebook's server, in its own database. This is why you may
	74 …	+have your _classic_ nickname that everyone knows you by, but when you try to choose that as
	75 …	+a username, Facebook tells you it's already taken. The server had scanned the database of all
	76 …	+Facebook names to see if the one you asked for already exists in some row. Since it does, it asks
	77 …	+if you'd prefer to use "ClassicNicknameEveryoneKnowsMeBy2". If you choose that, it'll then add your
	78 …	+new nickname as a new row to the database.
	79 …	+
	80 …	+The essential point is that your personal, protected Facebook account is a metaphor, designed to
	81 …	+give you a feeling of security and a personalized, filtered view into your data. These accounts
	82 …	+protect your view from being seen by other users, and protect Facebook's private company data from
	83 …	+being seen by you. User accounts are effective metaphors, and provide a great user experience, but
	84 …	+do not reflect how your data is being physically held and processed. In reality, the server is
	85 …	+holding your memories, friends and photos in a big cyber stew of everyone’s friends, memories and
	86 …	+photos. From this view, things like “private messages” or “closed groups” don’t really mean
	87 …	+anything. This is because the structure and rules of your data is designed for Facebook's servers,
	88 …	+and not for you.
	89 …	+
	90 …	+You open a Private Message Window, add your Grandma as the recipient, and write her your message.
	91 …	+
	92 …	+When you click the send button on your private message, it doesn't actually send it to yourgrandma.
	93 …	+Instead, it sends it to Facebook's server with a request for them to please give your Grandma access
	94 …	+to it. Facebook stores your message in their database, and then decides whether or not they pass it
	95 …	+along.
	96 …	+
	97 …	+Giving Facebook this responsibility has some benefits. For example: if your grandmother blocked
	98 …	+you, for some reason, then Facebook would not send your message. Or, if you weren't friends with
	99 …	+your Grandma yet, then Facebook wouldn't send it directly to her, instead placing it in her 'other'
	100 …	+inbox so she doesn’t get too much non-friend spam. In most cases, they'll send your message as you
	101 …	+asked and do it so quickly you don't realize this exchange took place, but on a technical level, the
	102 …	+delivery of your private message is a decision Facebook gets to make, and you don't have any say in
	103 …	+the matter.
	104 …	+
	105 …	+There's quite a lot that happens when you add your message to Facebook’s server, besides it being
	106 …	+eventually sent to your grandma. This is a partial summary of some of the decisions and processes
	107 …	+that take place.
	108 …	+
	109 …	+First, a package is sent from your computer to Facebook's server, where it will now reside. This
	110 …	+package says:
	111 …	+ - I would like to send a message to my grandma.
	112 …	+ - I want this message to be private.
	113 …	+ - here are the contents: "Hi! Grandma, how was book club yesterday?"
	114 …	+
	115 …	+Facebook parses the entirety of the message, the context of it withinyour relationship to your
	116 …	+grandma, and the conclusions it can draw from the exchange. Then it uses all these things to make
	117 …	+some money.
	118 …	+
	119 …	+This isn't necessarily evil. Facebook _needs_ to make money to keep its server running, as that’s
	120 …	+what keeps the site online. Since all of Facebook.com lives on this, it gets expensive: There's the
	121 …	+price of the warehouse, the cost of the actual physical devices holding the information, the staff
	122 …	+maintaining this hardware, the staff continually working on the software to keep it technically
	123 …	+updated and secure, and the staff handling the upkeep of the space itself. There’s also all the
	124 …	+people working in some way for Facebook(the company), and they need to get paid too.
	125 …	+
	126 …	+Facebook chose advertising, essentially, as their business model. They sell ad space, like many
	127 …	+sites do. What makes Facebook powerful, though, is that they can offer targeted ad space--in other
	128 …	+words, they give advertisers the ability to reach the right people with the right things at the
	129 …	+right time. Facebook does this by accumulating as much data as possible from you and your social
	130 …	+connections, from which they build a highly specific customer profile of you. They can then sell
	131 …	+the ad space of your specific partition to the companies that want to target your profile. This
	132 …	+helps the companies make sure their marketing budget is bringing in the highest return on
	133 …	+investment.
	134 …	+
	135 …	+Since all Facebook activity is stored within a central server, Facebook is able to make some
	136 …	+stunning connections and conclusions from the data available to them — connections you may not see.
	137 …	+
	138 …	+For example, they quickly parse your message and conclude that the specific user account you chose
	139 …	+as the message recipient is your grandma, which puts her in a generational demographic. They also
	140 …	+know you submitted the message on a Thursday, but asked about a book club that happened yesterday.
	141 …	+So they know your grandma has a regular book club on Wednesdays. Next, they look at all your
	142 …	+grandma's other private messages, and find several from someone named Victor who always messages her
	143 …	+"Sorry, i'm going to be late! Should I bring anything?" at 12:30 pm on Wednesday. They find several
	144 …	+other friends writing "what a great time!" around 4 pm. So they conclude that the book club is
	145 …	+likely happening from 1 to 3 and that Victor is a member. In addition, they have a small
	146 …	+personality sketch of Victor.
	147 …	+
	148 …	+As they have all of Victor's other data, they can read through any of his private or public
	149 …	+messages. They find a private message from December asking how he likes his new iPhone. They also
	150 …	+find a public message from him exclaiming "So much to do, and not enough time!" further solidifying
	151 …	+his customer profile.
	152 …	+
	153 …	+All of this culminates next Wednesday morning, when an advertisement for Audible.com is placed on
	154 …	+Victor's Facebook feed. Facebook knows he'll be going to a book club, is always pressed for time,
	155 …	+has an iPhone, and would probably be susceptible to signing up for some audio books. They could
	156 …	+even use data they're pulling from other sites they maintain a presence on (usually through a like
	157 …	+or share button). For example, they could see Victor bought a specific mystery thriller from Amazon
	158 …	+that your grandma also bought, determine it's a _mystery_ book club the two of them are in, and
	159 …	+adjust the book featured in the Audible advertisement so it’s even more persuasive.
	160 …	+
	161 …	+In this way, a message you sent to your grandma is used to adjust and target the ads for someone you
	162 …	+may have never met. This also helps explain the eerie phenomenon where you are talking in-person
	163 …	+about some upcoming trip that you've never talked about online, and the next day see an add for that
	164 …	+destination on your facebook feed. This could happen because Facebook has bugged your phone and is
	165 …	+listening in on your conversations, or it’s because your friends are talking about you on Facebook
	166 …	+and not telling you. The truth to this paranoia is known only by Facebook.
	167 …	+
	168 …	+With all of the social connections and content you've shared on their network, Facebook has compiled
	169 …	+highly detailed dossier on who you are. This dossier is useful to sell you things, but they found
	170 …	+that the dossier itself can be sold to interested parties. Often, these parties aren't doing any
	171 …	+marketing at all.
	172 …	+
	173 …	+One known party is law enforcement. Security companies have built software intended to help police
	174 …	+find criminals before they've even committed a crime. They do this by pulling in as much data from
	175 …	+social networks as possible, comparing the conversations and activities of the larger population
	176 …	+against people who have been arrested for crimes, and through this determine what sort of social
	177 …	+traits criminals share.
	178 …	+
	179 …	+What this means is that your inquiry about your grandma's bookclub might fit a trait for people
	180 …	+arrested for drug possession, and so when you submit your message you are privately tagged with the
	181 …	+labels "grandchild" and "likely drug offender" Or, you may already be on the list of likely drug
	182 …	+offender, and so your question to your grandma is added to the list of traits these potential
	183 …	+criminals may share. Or the opposite could be true, and your broader Facebook activity put you into
	184 …	+a "law-abider" category. In this case, your activity helps flesh out the "law abider" profile and
	185 …	+by extension the "likely criminal" profile. These profiles are then fed into a computer program that
	186 …	+tells your local police to go knock on someone's door and "check in", because that person didn't
	187 …	+write to their grandma this Thursday, and that seems "suspicious".
	188 …	+
	189 …	+While this example seems absurd, it is just this sort of small connection/large conclusion that is
	190 …	+the heart of "big data" analysis. Big Data is powered by a near-mystic belief that, by grabbing as
	191 …	+much data as possible and sorting it in as many ways as possible, compelling patterns will emerge
	192 …	+and these patterns can predict behaviors and futures.
	193 …	+
	194 …	+All of this data, the targeted adspace, the endless dossiers on who you are — these are worth a lot
	195 …	+of money to a broad set of people. And through selling the data that you generate, Facebook keeps
	196 …	+their servers online, letting them log valuable information on you plus everything else they want to
	197 …	+do. It is how their service stays both free and incredibly profitable.
	198 …	+
	199 …	+Your Grandma receives the message
	200 …	+
	201 …	+Now thoroughly vetted, Facebook has the responsibility to send your message to your grandma. But
	202 …	+they may choose a couple different routes, which--since it's on their servers--they have the right
	203 …	+to do.
	204 …	+
	205 …	+If your grandma is on Facebook often, they may decide to show it to her the next time she logs in,
	206 …	+but they'll do so after some random amount of time, to make logging on feel more appealing.
	207 …	+
	208 …	+It's exciting when you have a new notification. It gives you a quick dopamine thrill like seeing
	209 …	+a package in front of your door. Facebook knows this, and knows that this makes their service
	210 …	+addicting, so they try to accentuate this rush as much as possible. So your grandma might sign on
	211 …	+and see nothing in the notification bar for nearly a second, before a bright red '1' appears. Since
	212 …	+she's on the site often, she'll naturally learn that there is this delay, but since it's random she
	213 …	+won't be able to predict how long the delay will be. And so the act of logging on and waiting for
	214 …	+a notification will become a thrilling game of chance, similar to a slot machine.
	215 …	+
	216 …	+If she isn't on the site much, then Facebook may use your message to try to get her back. They've
	217 …	+already read its contents, and know that you're her grandchild, and assume that messages from family
	218 …	+are great leverage for converting someone back into a user. They also likely have her email and
	219 …	+phone number on file, as they asked for both when she signed up. So they will send her an email
	220 …	+with a brief message like "your grandchild wants to talk to you" with a link to get directly into
	221 …	+facebook. If that doesn't work, they may send a text message with something more direct like
	222 …	+"click this to log into facebook right away." In either case, the link they provide will have
	223 …	+a reference token to your message, so if she does log on they'll know that _you_ are the reason why.
	224 …	+They will then subtly alter her newsfeed so that your posts show up more often, since you’ve talked
	225 …	+recently and she must be interested in how you are doing.
	226 …	+
	227 …	+Since user data is their main source of income, they need their users on their site as much as
	228 …	+possible. Even if your grandma wants to take a social media break, it is in Facebook's best
	229 …	+interest to win her back as quickly as possible, and get her addicted as completely as possible.
	230 …	+Your message acts as that addicting hook. In a way, this helps you too, since them selling the fact
	231 …	+that you can influence your grandma helps keep their servers online, and the servers are required
	232 …	+for you to send the message at all.
	233 …	+
	234 …	+Messages are Read and everyone's happy
	235 …	+
	236 …	+In centralized systems, the company and it's servers acts as the intermediary for all activity.
	237 …	+There is no way for you to send a message directly to your grandma on facebook. By design, Facebook
	238 …	+has to intercept, store, and send the message for you.
	239 …	+
	240 …	+In this example scenario your grandma receives the message, Victor signs up for Audible, the cops
	241 …	+have a potential new arrest, and everyone is happy. But there are a couple ways this could have
	242 …	+gone wrong, due to it being a centralized model.
	243 …	+
	244 …	+For one, the server that holds your message could have gone down. Since it’s a physical object, the
	245 …	+reason could be as simple as the device getting unplugged. Since the data centers holding the
	246 …	+servers are so huge, they need to be placed in strategic geographic areas, which makes the system
	247 …	+far more fragile than we realize. There have been incidents where, for example, a farmer
	248 …	+accidentally plows right through a remote server cable in their field, and the farmer accidentally
	249 …	+causes a large portion of the internet to go down for hours. There have been other cases where an
	250 …	+employee in charge of maintaining the server forgets some crucial step, and causes a software mishap
	251 …	+that shuts down another part of the internet. These scenarios don't happen often, but are
	252 …	+a necessary risk within centralized systems.
	253 …	+
	254 …	+Alternately, Facebook may find their income model doesn't work and they go out of business. Since
	255 …	+they own the servers, and the data you've placed within them, if they go out of business, then your
	256 …	+messages disappear with them. Most likely, Facebook would tell you they're shutting down, and offer
	257 …	+a way for you to export all your photos, stories, and memories. This is a nicety though, and one
	258 …	+that they do not have to offer. They may not get the chance to do this nicety, either. For
	259 …	+example, two news sites (DNAinfo and TheGothamist) were recently shut down without notice by their
	260 …	+owner because he disagreed with the staff wanting to unionize. In this case, he pulled them offline
	261 …	+so quickly that no professional contributor was able to retrieve the work they had published.
	262 …	+Resumes and portfolios were full of dead links and lack of proof, because of the learned assumption
	263 …	+to rely on a “data cloud”, which is another metaphor intended to hide servers from your view.
	264 …	+Fortunately, the personal data you store on Facebook is worth a lot of money, and Mark Zuckerberg
	265 …	+has promised that he is very nice, so it isn’t likely that they’ll remove your photos anytime soon.
	266 …	+
	267 …	+However, Facebook may also determine that you are not a good fit for their site and block your
	268 …	+access to it. Since access to your account is a metaphor they created, they can easily and legally
	269 …	+do this. In that case, your old information would still live and be sold on the server, but be
	270 …	+inaccessible by you. In extreme cases, a government may decide that Facebook (or its servers) must
	271 …	+be shut down, due to some profound shift in power. In that case, policy-abiding users would have
	272 …	+little say.
	273 …	+
	274 …	+Conclusion
	275 …	+
	276 …	+A centralized system like Facebook offers you a way to stay in touch with friends and loved ones. As
	277 …	+you can see, the way you do so is pretty simple, though with a few unexpected steps. A decentralized
	278 …	+model lets you send messages and stay in touch too, but without the need for a central server, and
	279 …	+all the hidden costs and companies that requires.
	280 …	+
	281 …	+
	282 …	+
	283 …	+

ssb-in-context/twitter-tutorial.mdView
		@@ -1,0 +1,13 @@
	1 …	+#Understanding Centralized Models: How to Send an Effective Tweet
	2 …	+
	3 …	+[Part of SSB-in Context](/ssb-in-context/README.md)
	4 …	+
	5 …	+Objective
	6 …	+
	7 …	+Show how to craft a perfect tweet to be seen by your friends. At the start it will be a simple tweet like "Feeling like some friendship today, who's up for lunch?".
	8 …	+
	9 …	+Explains how, when sending a tweet, you are adding it to Twitter's massive database, and twitter then decides how to send this to your friends. Since they are trying to get people scrolling through their feed for as long as possible (so they can display ads within the feed, as that is the main business model), then they algorithmically determine which tweets will have the most profound, addicting effect on your friends.
	10 …	+
	11 …	+Because of this, the tweet first sent seems to get little reply, while you meanwhile are scrolling throough your own feed. You steadily adjust teh wording of your following tweets to get better numbers (likes and retweets), and to better be seen within this unknowable algorithm. By the article's end, the most effective tweet is the one that 'games' the system and expresses none of your real feelings at all.
	12 …	+
	13 …	+

ssb-intro-video.mdView
		@@ -1,0 +1,26 @@
	1 …	+# SSB Intro Video
	2 …	+
	3 …	+Objective
	4 …	+
	5 …	+Craft a 30sec to 1minute video enthusing upon the awesome things about Scuttlebutt--both the technology and the culture that is fermenting here. This video is not meant to be educational, but more marketable/excitable.
	6 …	+
	7 …	+The main thrust I'm envisioning now is "The Social Network of the Future, available today."
	8 …	+
	9 …	+It leans more on the radical potential of Scuttlebutt, and builds up awesome statements of what the future will be, with Scuttlebutt being a core part of it.
	10 …	+
	11 …	+e.g.:
	12 …	+
	13 …	+"The Future is Solarpunk"
	14 …	+"The Future is Diverse"
	15 …	+"The Future is Powered by Us and not by Corporations"
	16 …	+"The Future is Equal and Safe"
	17 …	+"The Future Feels Familiar"
	18 …	+"The Future is Fun"
	19 …	+"The Future is Decentralized"
	20 …	+"The Future is Available Today"
	21 …	+
	22 …	+I am not yet sure how much imagery of SSB should be used, and how much of this should just be pure _art_ that acts kinda like a manifesto, rather than some tutorial of what scuttlebutt is.
	23 …	+
	24 …	+Perhaps there could be a 30 second video as well as an "Extended Cut" that goes into more details of each of these Future Postulates.
	25 …	+
	26 …	+

tips-for-getting-started.mdView
		@@ -1,0 +1,17 @@
	1 …	+# Tips for Getting Started
	2 …	+
	3 …	+Objective
	4 …	+
	5 …	+
	6 …	+This would be a video/article about how to post, and what to post. How to subscribe to a channel, and what a channel means. The difference between public and private posts,
	7 …	+Some popular topics to check out, and other encouragement to help new folks express their unique selves within our unique 'verse.
	8 …	+
	9 …	+Tips:
	10 …	+- Check out these channels
	11 …	+- Don't be afraid to start your own channel
	12 …	+- How to send a private message
	13 …	+- How to tag things
	14 …	+- Where to find markdown style guides
	15 …	+- Some core cultural things you'll find from us(we don't like hateful people, we love everyone else, and are friendly!)
	16 …	+
	17 …	+

what-is-solarpunk.mdView
		@@ -1,0 +1,6 @@
	1 …	+# What is Solarpunk?
	2 …	+
	3 …	+Objective
	4 …	+
	5 …	+Solarpunk comes up a lot within the 'verse, and is a badge of pride and tribal identity for us. For folks who may not know what this means, this article explains solarpunk's key ideals and aesthetics and then includes concrete examples of the solarpunk lifestyle from within Scuttlebutt.
	6 …	+

Built with git-ssb-web

Zach! / non-dev-resources

Commit 0e093f8a99310fc4a8f30de0c990d3a03e17ef25

Fill out the Repo with Sketches

Files changed