Add snippet, design goal & wording

README.md

@@ -3,9 +3,20 @@
 `exporter.js` is a console snippet to export your account from [Manyland](https://manyland.com) (creations, collections, snaps, etc), and potentially import it back to [Offlineland.io](https://offlineland.io)
 
 
+To run, make sure you're logged in in-game, go to [the info-rift page](https://manyland.com/info-rift), then copy-paste this snippet into the console:
+```
+fetch("https://raw.githubusercontent.com/offlineland/exporter/main/exporter.js").then(res => res.text()).then(txt => eval(txt));
+```
+
+You can find more detailed informations [here](https://offlineland.io/exporter).
+
+
 
 ## For developers:
 
+The goal of this exporter is to save _private_ data off of Manyland into a self-contained format (usable as-is for people to dig through all of their manyland content). The exported data can also be re-imported in [Offlineland](https://offlineland.io).
+Exporting should not hammer the manyland servers: throttle the downloads, and avoid downloading public data (that is unrelated to the user) as it's all in the archives already.
+
 The actual work is done on the `exporter.ts` file (`.ts` instead of `.js`) because I can't live without types. To set up a dev env:
 
 - install dependencies:
@@ -29,18 +40,19 @@ Typescript really really wants to include them (because exporter.ts is considere
 (If you manage to have tsc pick up the type for Zod.infer without using the `import/export type ...` syntax you're a god please help me)
 
 
-### What is Bun?
+### About the dependencies we fetch
+#### Bun
 [Bun](https://bun.sh) is a "fast all-in-one JavaScript runtime". It's basically Node.js or Deno, except faster and way more convenient and has everything built-in
 
 You should be able to replace `bun` above with `yarn` or `npm`, but I use `bun` for convenience in all the offlineland repos.
 
-### What is Zod?
+#### Zod
 [Zod](https://zod.dev/) is a powerful parsing + validation library; ideally I'd use it to validate all incoming data, but manyland's api is so full of holes and exceptions that I don't want to have it fail mid-way, so the exporter is mostly archiving everything as-is.
 
-### What is RE:DOM?
+#### RE:DOM
 [RE:DOM](https://redom.js.org/) is a "tiny turboboosted javascript library for creation user interfaces" - it's basically React, except way more barebones and no JSX. I use it because I didn't want to add all the annoying react tooling and a heavy transpilation step, and the exporter really doesn't need much.
 
 It's a bit unsightly right now because I wrote 99% of it in a very basic style because I couldn't get my editor to work the types out, sorry about that!
 
 
-The other libs are pretty self-explanatory: `JSZip` for zipping, `csv-stringify` for generating the .csv files, `file-saver` to be able to download the zip, and `idb` as a lightweight wrapper around the awful IndexedDB api.
+The other libs are pretty self-explanatory: `JSZip` for zipping, `csv-stringify` for generating the .csv files, `file-saver` to be able to download the zip, and `idb` as a lightweight wrapper around the awful IndexedDB API.