[omni] Better docs

Author: jamesgpearce

site/guides/01_the_basics/7_importing_tinybase.md

@@ -42,9 +42,8 @@ It includes the following submodules:
 - The mergeable-store module
 - The common module
 
-Since many of the submodules above share compiled-in dependencies, the
-master package is smaller to include than including all of the submodules
-separately.
+Since many of the submodules above share compiled-in dependencies, the master
+package is smaller to include than including all of the submodules separately.
 
 However, for a very minimal set of submodules, you may save size by including
 them piecemeal. If you only wanted a Store and a Metrics object, for example,
@@ -66,10 +65,27 @@ in the main tinybase module, but should be imported separately from inside the
 `persisters` and `synchronizers` folders. See the Persistence and
 Synchronization guides, respectively, for more details.
 
+## The `omni` Module
+
+There is also an `omni` module that is an explicit superset of everything in the
+TinyBase ecosystem. It exports the features and functionality of every
+`tinybase/*` module, including every persister, every synchronizer, and every UI
+component. This is useful for applications that want to use multiple facets of
+the overall TinyBase ecosystem and also benefit from the fact they share a lot
+of code internally.
+
+```js yolo
+import {createStore, createSqliteBunPersister} from 'tinybase/omni';
+```
+
+However, it should go without saying that you should only use the `omni` module
+if you have a good tree-shaking bundler that can remove all the persisters,
+synchronizers, and so on, that you do _not_ use.
+
 ## Targets And Formats
 
-Prior to TinyBase v6.0, the NPM package included a number of different versions of
-each module, transpiled for different targets and formats. From v6.0 onwards,
+Prior to TinyBase v6.0, the NPM package included a number of different versions
+of each module, transpiled for different targets and formats. From v6.0 onwards,
 only ESNext, ESM modules are included in the main package.
 
 However, both non-minified and minified versions are available: the default is
@@ -97,9 +113,8 @@ import {createStore} from 'tinybase/with-schemas';
 ## Putting It All Together
 
 As long as you put the optional parts of the path in the right order, you can
-access all the valid combinations of minification, sub-module
-and schema support. The syntax for the import (split onto different lines for
-clarity) is:
+access all the valid combinations of minification, sub-module and schema
+support. The syntax for the import (split onto different lines for clarity) is:
 
 ```sh yolo
 tinybase

site/guides/15_releases.md

@@ -7,34 +7,48 @@ highlighted features.
 
 # v6.2
 
-## with-schema exports
+This release contains various packaging improvements and exposes some internal
+HLC functions that are useful for people building their own persisters or
+synchronizers.
 
-This release changes the `package.json` exports slightly so that imports of both
-`/with-schema` and non-schema'd versions of the modules resolve to the same
-JavaScript file. This reduces bundle size for apps that use both schema and
-non-schema imports.
+## HLC functions
+
+The common module (and hence tinybase module) now export the getHlcFunction
+function. This returns set of seven functions that can be used to create and
+manipulate HLC (Hybrid Logical Clock) timestamps.
+
+```js
+const [getNextHlc, seenHlc, encodeHlc] = getHlcFunctions();
+```
+
+If needed, you can use these in your own systems to ensure the timestamps are
+compatible with the ones generated in TinyBase MergeableStore objects.
 
 ## New `omni` module
 
-The new `omni` module is an explicit superset of everything in the TinyBase
-ecosystem. It includes all the features and functionality of the existing
-modules, including every persister, every UI component, and every synchronizer.
-This is useful for applications that want to use multiple facets of the overall
-TinyBase ecosystem and also benefit from the shared code they use internally.
+There is a new `omni` module that is an explicit superset of everything in the
+TinyBase ecosystem. It exports the features and functionality of every
+`tinybase/*` module, including every persister, every synchronizer, and every UI
+component. This is useful for applications that want to use multiple facets of
+the overall TinyBase ecosystem and also benefit from the fact they share a lot
+of code internally.
+
+```js yolo
+import {createStore, createSqliteBunPersister} from 'tinybase/omni';
+```
 
 However, it should go without saying that you should only use the `omni` module
 if you have a good tree-shaking bundler that can remove all the persisters,
-synchronizers, and so on, that you do NOT use.
+synchronizers, and so on, that you do _not_ use.
 
-## HLC functions
+## with-schema exports
 
-The common module (and hence tinybase module) now export the getHlcFunction
-function. This returns set of seven functions that can be used to create and
-manipulate HLC (Hybrid Logical Clock) timestamps. If needed, you can use these
-in your own systems to ensure the timestamps are compatible with the ones
-generated in TinyBase MergeableStore objects.
+This release changes the `package.json` exports slightly so that imports of both
+`/with-schema` and non-schema'd versions of the modules resolve to the same
+JavaScript file. This reduces bundle size for apps that use both schema and
+non-schema imports.
 
-## Move of the GetNow type
+## Moving the GetNow type
 
 The rarely-used GetNow type has been moved from the mergeable-store module into
 the common module.
@@ -49,8 +63,7 @@ the common module.
 - [Destructured object
   arguments](#destructured-object-arguments-for-sorted-row-ids) for sorted Row
   Id methods and hooks.
-- [A new startAutoPersisting
-  method](#new-startautopersisting-method).
+- [A new startAutoPersisting method](#new-startautopersisting-method).
 
 And more!
 

site/home/index.md

@@ -8,7 +8,7 @@
 
 <a href='/guides/releases/#v6-2'><em>NEW!</em> v6.2 release</a>
 
-<span id="one-with">"The One With New Stuff. TBA!"</span>
+<span id="one-with">"The One With HLCs and `omni`!"</span>
 
 <a class='start' href='/guides/the-basics/getting-started/'>Get started</a>