paperlint 14.0.0 → 14.2.0

package/skills/build-label-page/scripts/label-page.js

@@ -41,6 +41,11 @@
  *     "seed": 7,                            fixes the order; change it and every id changes
  *     "groups": {"python": "Python"},
  *     "labeller_knows": ["python"],         optional: items of other groups are not put on the page
+ *     "answerers": ["author", "second"],   optional, 2 or more: each answers under their own name;
+ *                                           documents become `<answerer>~<id>`; an item's own
+ *                                           `answerers` (a subset) shows it to those only
+ *     "min_seconds": 30,                    optional: an answer saves only after its card was on
+ *                                           screen that long; stored as `seconds`
  *     "familiarity": true,                  optional: a "how well do you know" question per group;
  *                                           left out, none is asked (an approval page)
  *     "familiarity_question": "How well do you know {group}?",          optional
@@ -49,8 +54,8 @@
  *                                 "icon": "✅"},                      icon: optional
  *                                {"value": "no", "label": "No", "example": "another real case",
  *                                 "icon": "❌", "ask_why": "What is wrong with it?"}]}],
- *                                           ask_why: optional; the answer is incomplete until a
- *                                           reason is given. In any shown text, backticks render
+ *                                           ask_why: optional; the answer is not saved until a
+ *                                           reason is typed. In any shown text, backticks render
  *                                           as code.
  *     "practice": [{"body": "…", "expected": {"label": "yes"}, "why": "one line"}, …],   3 or more;
  *                                           a practice card may carry rules, unit, readings, file
@@ -66,6 +71,12 @@
  *                                           requirement marked in it; id (never shown) tells two
  *                                           places with the same words apart. kind approval requires
  *                                           unit and rules; kind witness rules, readings and file.
+ *                                           Content blocks (situation, excerpt, references, more,
+ *                                           table, repeat) and page `labels`: optional on any kind
+ *                                           (references/closed-choice-generator.md, and
+ *                                           scripts/fixtures/blocks-items.json for a whole page);
+ *                                           "preset": "<name>" maps a preset's own card fields onto
+ *                                           them (scripts/label-page-presets.ts).
  *   }
  *
  * TypeScript, compiled beside itself to `label-page.js` by `npm run build`: a consumer runs the skill

package/skills/build-label-page/scripts/label-page.ts

@@ -41,6 +41,11 @@
  *     "seed": 7,                            fixes the order; change it and every id changes
  *     "groups": {"python": "Python"},
  *     "labeller_knows": ["python"],         optional: items of other groups are not put on the page
+ *     "answerers": ["author", "second"],   optional, 2 or more: each answers under their own name;
+ *                                           documents become `<answerer>~<id>`; an item's own
+ *                                           `answerers` (a subset) shows it to those only
+ *     "min_seconds": 30,                    optional: an answer saves only after its card was on
+ *                                           screen that long; stored as `seconds`
  *     "familiarity": true,                  optional: a "how well do you know" question per group;
  *                                           left out, none is asked (an approval page)
  *     "familiarity_question": "How well do you know {group}?",          optional
@@ -49,8 +54,8 @@
  *                                 "icon": "✅"},                      icon: optional
  *                                {"value": "no", "label": "No", "example": "another real case",
  *                                 "icon": "❌", "ask_why": "What is wrong with it?"}]}],
- *                                           ask_why: optional; the answer is incomplete until a
- *                                           reason is given. In any shown text, backticks render
+ *                                           ask_why: optional; the answer is not saved until a
+ *                                           reason is typed. In any shown text, backticks render
  *                                           as code.
  *     "practice": [{"body": "…", "expected": {"label": "yes"}, "why": "one line"}, …],   3 or more;
  *                                           a practice card may carry rules, unit, readings, file
@@ -66,6 +71,12 @@
  *                                           requirement marked in it; id (never shown) tells two
  *                                           places with the same words apart. kind approval requires
  *                                           unit and rules; kind witness rules, readings and file.
+ *                                           Content blocks (situation, excerpt, references, more,
+ *                                           table, repeat) and page `labels`: optional on any kind
+ *                                           (references/closed-choice-generator.md, and
+ *                                           scripts/fixtures/blocks-items.json for a whole page);
+ *                                           "preset": "<name>" maps a preset's own card fields onto
+ *                                           them (scripts/label-page-presets.ts).
  *   }
  *
  * TypeScript, compiled beside itself to `label-page.js` by `npm run build`: a consumer runs the skill