Docs and emoji picker and probably some other random app updates.

git-svn-id: https://www.unprompted.com/svn/projects/tildefriends/trunk@4124 ed5197a5-7fde-0310-b194-c3ffbd925b24

apps/cory/docs/index.md

@@ -2,9 +2,10 @@
 
 Tilde Friends is a participating member of a greater social
 network, [Secure Scuttlebutt](https://scuttlebutt.nz/),
-augmenting it with a way to safely and securely write, share,
-and run code.
+adding a way to safely and securely write, share,
+and run code in the form of server-side web applications.
 
+- [Tilde Friends Vision](#vision)
 - [Secure Scuttlebutt from Scratch](#ssb)
 - [Structure](#structure)
 - [Guide](#guide)

apps/cory/docs/ssb.md

@@ -16,6 +16,8 @@ IPv4 addresses.
 
 So be prepared to accept variations.
 
+There also an undocumented "new" style of discovery message.
+
 ## Secret Handshake, Box Stream, and RPC Protocol
 Now that two clients are aware of eachother, they need to complete a secret handshake.
 The [programming guide](https://ssbc.github.io/scuttlebutt-protocol-guide/#handshake)
@@ -26,12 +28,14 @@ The box stream and RPC protocol can both be implemented from the
 without surprises.
 
 ## Synchronizing Data
-So now you're discovering other clients on the local network, connecting, performing
-a secret handshake, and making remote procedure calls over box streams.  The next step
-is to start synchronizing feeds over the network.  The goal, after all, is to author
-messages in your local append-only log and have them show up in distant clients, or
-vice versa.
+
+... `ebt.replicate` or `createHistoryStream` ...
+
+## Rooms
+
+TODO
 
 ## References
 * [https://ssbc.github.io/scuttlebutt-protocol-guide/](https://ssbc.github.io/scuttlebutt-protocol-guide/)
-* [https://dev.planetary.social/](https://dev.planetary.social/)
+* [https://dev.planetary.social/](https://dev.planetary.social/)
+* [https://dev.scuttlebutt.nz/#/golang/?id=muxrpc-endpoints](https://dev.scuttlebutt.nz/#/golang/?id=muxrpc-endpoints)

apps/cory/docs/structure.md

@@ -21,7 +21,7 @@ In combines the following key components:
   are mediated through the core process.
 
 When run with no arguments, it starts a web server on
-[http://localhost:12345/](http://localhost:12345/) and an SSB server.
+[http://localhost:12345/](http://localhost:12345/) and an SSB node.
 
 ## Web Interface
 The Tilde Friends web server provides access to Tilde Friends applications,

apps/cory/docs/todo.md

@@ -5,8 +5,6 @@
 - Sync status (problem feeds, messages/seconds stats, ...)
 - app: wiki
 - app: public blog
-- app: build archive
-- app: todo
 - Content-Disposition: download
 - remove SSB credentials
 - export SSB credentials
@@ -22,7 +20,6 @@
 - fix weird HTTP warnings
 - ssb from child process?
 - channels
-- image downsample
 - placeholder/missing images
 - no denial of service
 - package standalone executable
@@ -30,12 +27,16 @@
 - editor without app iframe
 - sequence_before_author -> flags
 - linkify ssb: links
+- perfect rooms support
 
 ## MVP2
 - connections 2.0
 - make a better connections API
 
 ## Maybe Done
+- image downsample
+- app: todo
+- app: build archive
 - update README
 - administrators config	
 - apps name characters

apps/cory/docs/vision.md

@@ -0,0 +1,62 @@
+# Tilde Friends Vision
+[Back to index](#index)
+
+Tilde Friends is a tool for making and sharing.
+
+It is both a peer-to-peer social network client, participating in Secure
+Scuttlebutt, and an environment for creating and running web applications.
+
+## Why
+
+This is a thing that I wanted to exist and wanted to work on.  No other reason.
+There is not a business model.  I believe it is interesting and unique.
+
+## Goals
+1. Make it **easy and fun** to run all sorts of web applications.
+
+2. Provide **security** that is easy to understand and protects your data.
+
+3. Make **creating and sharing** web applications accessible to anyone with a
+   browser.
+
+## Ways to Use Tilde Friends
+1. **Social Network User**: This is a social network first.  You are just here,
+   because your friends are.  Or you like how we limit your message length or
+   short videos or whatever the trend is.  If you are ambitious, you click links
+   and see interactive experiences (apps) that you wouldn't see elsewhere.
+
+2. **Web Visitor**: You get links from a friend to meeting invites, polls, games,
+   lists, wiki pages, ..., and you interact with them as though they were
+   cloud-hosted by a megacorporation.  They just work, and you don't think twice.
+
+3. **Group leader**: You host or use a small public instance, installing apps for
+   a group of friends to use as web visitors.
+
+4. **Developer**: You like to write code and make or improve apps for fun or to
+   solve problems.  When you encounter a Tilde Friends app on a strange server,
+   you know you can trivially modify it or download it to your own instance.
+
+## Future Goals / Endgame
+1. Mobile apps.  This can run on your old phone.  Maybe you won't be hosting
+   the web interface publicly, but you can sync, install and edit apps, and
+   otherwise get the full experience from a tiny touch screen.
+
+2. The universal application runtime.  The web browser is the universal
+   platform, but even for the simplest application that you might want to host
+   for your friends, cloud hosting, containers, and complicated dependencies might
+   all enter the mix.  Tilde Friends, though it is yet another thing to host,
+   includes everything you need out of the box to run a vast variety of interesting
+   apps.
+
+   Tilde Friends will be built out, gradually providing safe access to host
+   resources and client resources the same way web browsers extended access to
+   resources like GPU, persistent storage, cameras, ... over the years.
+
+   Not much effort has been put forward yet to having a robust, long-lasting API,
+   but since the client side longevity is already handled by web browsers, it
+   seems possible that the server-side API can be managed in a similar way.
+
+3. An awesome development environment.  Right now it runs JavaScript from the
+   first embeddable text editor I could poorly configure enough to edit code,
+   but it could incorporate a debugger, source control integration a la ssb-git,
+   merge tools, and transpiling from all sorts of different languages.