demoman 0.9.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/recipe.md CHANGED
@@ -53,16 +53,17 @@ as `secretsFileNotIgnored` or `secretsFileInvalid` will be). Never a value.
53
53
  A page behind a login answers `signedOut` and `status` shows no account for
54
54
  its site. Then, in order:
55
55
 
56
- 1. **Reuse first.** Read each account's `about` and pick the one that fits
57
- the demo. Name it in the script's `account`, or omit it for the `default`.
56
+ 1. **Reuse first.** Pick the account whose `about` fits the demo. Name it in the script's `account`, or omit it for the `default`.
58
57
  2. **The app's repo is open and runs against a local development database:**
59
58
  create a demo account and the data the demo needs, with a seed script
60
- committed in the app and safe to run twice (`priv/repo/demo_seeds.exs`,
61
- `db/seeds/demo.rb`). Generate a random password of 20 or more characters.
59
+ committed in the app and safe to run twice (`db/seeds/demo.rb`); a reset
60
+ script goes in `.demoman/app.json` as `reset`.
61
+ Generate a random password of 20+ characters.
62
62
  Write `DEMOMAN_SECRET_<NAME>=…` and
63
63
  `DEMOMAN_SECRET_<NAME>_ORIGIN=<the site's origin>` to
64
64
  `.demoman/secrets.env`, and `.gitignore` it if missing. Add the
65
- account to `accounts.json`, tell the user in a line, `snapshot` again.
65
+ account to `accounts.json`, formatted as the repo's formatter writes it
66
+ (its CI lints it), tell the user in a line, `snapshot` again.
66
67
  3. **Two-factor or a magic link in the way:** add a dev-only "sign in as"
67
68
  route, reachable only in development, and make the account's `signIn` one
68
69
  `goto` to it. Phoenix:
@@ -70,8 +71,8 @@ its site. Then, in order:
70
71
  It starts a session only.
71
72
  4. **The database is not clearly local** (a remote `DATABASE_URL`, staging,
72
73
  production): create nothing. Ask the user, or give them
73
- `npx demoman signin <url>`, which signs in by hand in a window: it is the
74
- way for a real account, single sign-on and two-factor.
74
+ `npx demoman signin <url>`, which signs in by hand in a window: the way
75
+ for a real account, single sign-on and two-factor.
75
76
 
76
77
  The file, with one account:
77
78
 
@@ -176,7 +177,6 @@ targets, leaving the page open. Each entry is
176
177
  again after the page changes. `value`: a field's text, never a password's.
177
178
  `unresolvable`: no target reaches it. `notExamined` above 0: pass `contains`
178
179
  (name, text, stableId, kind, value) to narrow. `containsNote`: no match.
179
- - Iframe and shadow-root elements are not listed.
180
180
  - A snapshot sees only the page as it loads: hidden content in the
181
181
  page is listed; content a click creates (a menu, dialog, results, a new row) is not. To list it, `probe` your script
182
182
  cut off after the step that opens it, and copy targets from that answer. A probe acts on the app for real, as its description says: an "Add item"