docs: say where the library and the caches live

Dami committed Aug 1e351fbd

The README now names the fixed places: the .atlas library under the
application data directory on each platform, the stamped tile cache in
build/tiles, and the session state in localStorage - and states the
inverse, that nothing else is cached anywhere, so deleting the data
directory is a complete reset.

commit: e351fbd9685b90c82002c4f2061eccced358ad12
parent: 06b3e84284b962bff3e933b798a8fdf6b15b9443
author: Dami <dami.etoile@gmail.com>

1 file changed, +24 -0wrap lines

README.md

++++++++++++++++++++++++

M README.md +24 -0

@@ -100,6 +100,30 @@ go generate .
100100 Neither the binary nor a bundle has any runtime dependency on `../gamemap`,101101 npm, or the network.102102 103+## Where everything lives104+105+Atlas keeps its game library and its build caches in fixed places:106+107+- **The library** — installed `.atlas` bundles, read and watched by the108+  running application, written by `go generate` and by the in-app importer:109+  `bundles/` under the application data directory. That is110+  `~/Library/Application Support/dev.felinestatemachine.atlas` on macOS,111+  `%AppData%\dev.felinestatemachine.atlas` on Windows, and112+  `~/.config/dev.felinestatemachine.atlas` on Linux (`os.UserConfigDir`,113+  the same convention the framework resolves). `index.json` beside the114+  bundles lists every build of every game, newest first.115+- **The tile cache** — `build/tiles` in this repository, ignored by git.116+  `tools/tiles` derives pyramids into it and stamps each one over its117+  sources, so regeneration re-derives only what changed; deleting the118+  directory costs a full re-derivation from `../gamemap`.119+- **Session state** — last game, camera, and panel arrangement live in the120+  WebView's localStorage under the same application identity; the packaged121+  data never mixes with it.122+123+Nothing else is cached anywhere: a bundle in the library is served straight124+out of its zip, and deleting the application data directory resets Atlas125+completely.126+103127 ## The .atlas format104128 105129 A `.atlas` file is a zip archive holding one game: `atlas.json` (the