Update website

Author: mbloch

docs/examples/data/globe.msx

@@ -40,7 +40,7 @@
     <article class="docs-article">
 
       <h1 id="gallery">Gallery</h1>
-<p>A collection of example maps made with Mapshaper. Each tile links to a full write-up with the recipe, the source data, and a one-click link to open the finished snapshot in the <a href="/">web app</a>.</p>
+<p>A collection of example maps made with Mapshaper. Each tile links to its own page with the recipe, the source data, and a link to open the finished map in the <a href="/">web app</a>.</p>
 <div class="gallery-grid">
   <a class="gallery-tile" href="/docs/examples/globe.html">
     <div class="gallery-tile-image">

docs/examples/data/us-states.msx

@@ -5,7 +5,7 @@ description: Example maps made with Mapshaper, with full source data and reprodu
 
 # Gallery
 
-A collection of example maps made with Mapshaper. Each tile links to a full write-up with the recipe, the source data, and a one-click link to open the finished snapshot in the [web app](/).
+A collection of example maps made with Mapshaper. Each tile links to its own page with the recipe, the source data, and a link to open the finished map in the [web app](/).
 
 <div class="gallery-grid">
   <a class="gallery-tile" href="/docs/examples/globe.html">

docs/gallery/index.html

@@ -419,7 +419,7 @@ <h2 id="helper-functions">Helper functions</h2>
 </ul>
 <p>JavaScript&#39;s built-in <code>Math</code>, <code>JSON</code>, <code>Number</code>, <code>String</code>, <code>Array</code>, <code>Date</code>, <code>Object</code> etc. are all available. Node-specific globals like <code>process</code>, <code>require</code> and <code>setTimeout</code> are not.</p>
 <h2 id="calc-expressions">Calc expressions</h2>
-<p><code>-calc</code> and any command&#39;s <code>calc=</code> option use the same context as <code>-each</code> plus a set of <em>aggregate</em> functions that operate over the entire group of features (or the entire layer for <code>-calc</code>). Each aggregate function takes a per-feature expression and reduces it to a single value across the group.</p>
+<p><code>-calc</code> and any command&#39;s <code>calc=</code> option use the same context as <code>-each</code> plus a set of <em>reduction functions</em> — functions that convert data from a group of features or an entire layer to a single value. Each reduction function takes a per-feature expression and reduces it across the group.</p>
 <table>
 <thead>
 <tr>
@@ -584,7 +584,7 @@ <h2 id="examples">Examples</h2>
 
 <span class="hljs-comment"># Sort polygons largest-first</span>
 mapshaper countries.geojson \
-  -<span class="hljs-built_in">sort</span> <span class="hljs-string">&#x27;-this.area&#x27;</span> \
+  -<span class="hljs-built_in">sort</span> this.area descending \
   -o sorted.geojson
 
 <span class="hljs-comment"># Look up one feature</span>
@@ -621,12 +621,12 @@ <h2 id="examples">Examples</h2>
 </code></pre>
 <h2 id="see-also">See also</h2>
 <ul>
-<li><a href="/docs/reference.html#-each"><code>-each</code></a> &mdash; the canonical feature-expression command</li>
+<li><a href="/docs/reference.html#-each"><code>-each</code></a></li>
 <li><a href="/docs/reference.html#-filter"><code>-filter</code></a></li>
 <li><a href="/docs/reference.html#-calc"><code>-calc</code></a></li>
 <li><a href="/docs/reference.html#-define"><code>-define</code></a>, <a href="/docs/reference.html#-include"><code>-include</code></a>, <a href="/docs/reference.html#-require"><code>-require</code></a></li>
 <li><a href="/docs/reference.html#-run"><code>-run</code></a></li>
-<li><a href="/docs/examples/basics.html">Basics</a> &mdash; recipes that put expressions to work</li>
+<li><a href="/docs/examples/basics.html">Basics</a> &mdash; many examples that use expressions</li>
 </ul>
 
       <div class="edit-link">

docs/gallery/index.html.md

@@ -259,7 +259,7 @@ JavaScript's built-in `Math`, `JSON`, `Number`, `String`, `Array`, `Date`, `Obje
 
 ## Calc expressions
 
-`-calc` and any command's `calc=` option use the same context as `-each` plus a set of *aggregate* functions that operate over the entire group of features (or the entire layer for `-calc`). Each aggregate function takes a per-feature expression and reduces it to a single value across the group.
+`-calc` and any command's `calc=` option use the same context as `-each` plus a set of *reduction functions* — functions that convert data from a group of features or an entire layer to a single value. Each reduction function takes a per-feature expression and reduces it across the group.
 
 | Function | Description |
 | --- | --- |
@@ -409,7 +409,7 @@ mapshaper events.csv \
 
 # Sort polygons largest-first
 mapshaper countries.geojson \
-  -sort '-this.area' \
+  -sort this.area descending \
   -o sorted.geojson
 
 # Look up one feature
@@ -447,9 +447,9 @@ mapshaper -i country.shp -require ./projection.js \
 
 ## See also
 
-- [`-each`](/docs/reference.html.md#-each) — the canonical feature-expression command
+- [`-each`](/docs/reference.html.md#-each)
 - [`-filter`](/docs/reference.html.md#-filter)
 - [`-calc`](/docs/reference.html.md#-calc)
 - [`-define`](/docs/reference.html.md#-define), [`-include`](/docs/reference.html.md#-include), [`-require`](/docs/reference.html.md#-require)
 - [`-run`](/docs/reference.html.md#-run)
-- [Basics](/docs/examples/basics.html.md) — recipes that put expressions to work
+- [Basics](/docs/examples/basics.html.md) — many examples that use expressions

docs/guides/expressions.html

@@ -1938,7 +1938,7 @@ Print mapshaper version.
 
 # Gallery
 
-A collection of example maps made with Mapshaper. Each tile links to a full write-up with the recipe, the source data, and a one-click link to open the finished snapshot in the [web app](/).
+A collection of example maps made with Mapshaper. Each tile links to its own page with the recipe, the source data, and a link to open the finished map in the [web app](/).
 
 <!-- mapshaper:gallery -->
 
@@ -2515,7 +2515,7 @@ JavaScript's built-in `Math`, `JSON`, `Number`, `String`, `Array`, `Date`, `Obje
 
 ## Calc expressions
 
-`-calc` and any command's `calc=` option use the same context as `-each` plus a set of *aggregate* functions that operate over the entire group of features (or the entire layer for `-calc`). Each aggregate function takes a per-feature expression and reduces it to a single value across the group.
+`-calc` and any command's `calc=` option use the same context as `-each` plus a set of *reduction functions* — functions that convert data from a group of features or an entire layer to a single value. Each reduction function takes a per-feature expression and reduces it across the group.
 
 | Function | Description |
 | --- | --- |
@@ -2665,7 +2665,7 @@ mapshaper events.csv \
 
 # Sort polygons largest-first
 mapshaper countries.geojson \
-  -sort '-this.area' \
+  -sort this.area descending \
   -o sorted.geojson
 
 # Look up one feature
@@ -2703,12 +2703,12 @@ mapshaper -i country.shp -require ./projection.js \
 
 ## See also
 
-- [`-each`](/docs/reference.html.md#-each) &mdash; the canonical feature-expression command
+- [`-each`](/docs/reference.html.md#-each)
 - [`-filter`](/docs/reference.html.md#-filter)
 - [`-calc`](/docs/reference.html.md#-calc)
 - [`-define`](/docs/reference.html.md#-define), [`-include`](/docs/reference.html.md#-include), [`-require`](/docs/reference.html.md#-require)
 - [`-run`](/docs/reference.html.md#-run)
-- [Basics](/docs/examples/basics.html.md) &mdash; recipes that put expressions to work
+- [Basics](/docs/examples/basics.html.md) &mdash; many examples that use expressions
 
 ---