spyret 0.2.0 → 0.3.0

package/README.md

@@ -37,8 +37,10 @@ runtime requirements. For portable snapshots and reconstruction, see the
 ## Pyret: import, describe, display
 
 A maintainer runs `npm run release:drive` and follows the
-[manual upload instructions](docs/RELEASING.md). Users then import the versioned
-wrapper in CPO to get typed rule constructors and diagram functions together:
+[CPO-save and Drive publishing instructions](docs/RELEASING.md). The native
+JavaScript file needs CPO per-file authorization; a public Drive upload alone
+is insufficient. Verify access with a second account before distributing the
+versioned wrapper, which combines typed rule constructors and diagram functions:
 
 ```pyret
 # Use the import line supplied by the library maintainer.
@@ -49,7 +51,7 @@ data Tree:
   | branch(left, right)
 sharing:
   method _spytial(self):
-    [list: S.orientation("left + right", [list: S.direction-below])]
+    [list: S.orientation("left + right", [list: S.below])]
   end
 end
 
@@ -61,7 +63,12 @@ a diagram. Compose rules with ordinary Pyret lists; constructors such as
 `orientation`, `align` and `group` handle their constraint/directive category.
 `S.diagram([list: 1, 2, 3])` also works without any hooks. To supply rules explicitly,
 use `S.diagram-with-rules(value, rules)`, or `S.diagram(value, yaml)` for YAML.
-See the [rule reference](docs/SPYTIAL_RULES_REFERENCE.md) for available constructors.
+See the [layout rule guide](docs/SPYTIAL_LANGUAGE.md) for examples and meaning,
+and the [rule reference](docs/SPYTIAL_RULES_REFERENCE.md) for every constructor.
+These examples use the 0.3.0 source API. The published v0.2.0 release wrapper
+uses names such as `S.direction-below`; `release:drive` prints an example
+matching the release it downloads. Version 0.3.0 also replaces fluent
+`.with-*` style options with named records and typed style blocks.
 
 The import form depends on the host and file: