Provide / link a tutorial.

[nathan-at-least]

The README of this repo doesn't explain how to use this technology.

From searching around issues, I found (via #332 (comment)) a link to https://ses-secure-ecmascript.readthedocs.io/en/stable/ which looks promising. However:

• I don't know if that tutorial is specific to this technology. It says "SES", and installation says npm install ses, whereas this repo is called "Endo". Are these the same or different?
• https://ses-secure-ecmascript.readthedocs.io/en/latest/ is content-less placeholder. Maybe that should link to stable?
• This comment, How do you use this? #332 (comment), links to https://github.com/endojs/endo/blob/master/packages/ses/README.md#compartment, but that doc has me fairly confused. It provides Install and Usage sections, but doesn't serve as a tutorial, more as a reference. It introduces many concepts, I'm not sure how to put them together. (I might understand better if I were a seasoned node dev?). IMO, that page could benefit from a tutorial section to complement the reference section.
• The comment How do you use this? #332 (comment) suggests things have changed significantly and the new README addresses them, but the current readme doesn't have a tutorial.

Here's what I'd like tutorial content on:

• Which tech should I use if I want to develop a general JS app with good security properties? (In particular, I'm curious about evaluating potentially malicious user-submitted code?) Is that Endo or SES?
• More broadly, how to Endo, SES, node, and agoric-sdk relate?
  • My guess is that agoric-sdk enables writing blockchain smart contracts atop Endo, but the latter is general purpose, right?
• How do I install the right tech for developing my general JS app (no blockchain/smart contract stuff)?
• How do I write & run a program that prints "hello world" to stdout or web console where the call site to print is confined, and there's explicit delegation of the authority for stdout/console.log?
• How do I write dependencies with confinement? (Basic example, maybe it reverses strings, so that my new app + 1 dependency prints "!dlroW olleH" )
• How do I use dependencies with confinement?
  • What are some symptoms I can see/expect if I try to use a dependency that violates confinement properties? (A tutorial of a simplified dependency which works in node but fails confinement in Endo would be helpful!)
  • If I am the dependency author, how can I rewrite the toy example to work with confinement?
  • If I am not the dependency author, how can I write a shim to use the dependency?
• How do I write & run a basic distributed program? (Maybe a simple ping/pong protocol?)
• Link to reference material (architecture, APIs, security properties, etc…)