docs: demo annotations

packages/assert/src/types.js

@@ -193,12 +193,13 @@
  * payload itself is still passed unquoted to the console as it would be
  * without `quote`.
  *
+ * @example
  * For example, the following will reveal the expected sky color, but not the
  * actual incorrect sky color, in the thrown error's message:
  * ```js
  * sky.color === expectedColor || Fail`${sky.color} should be ${quote(expectedColor)}`;
  * ```
- *
+ * @example
  * The normal convention is to locally rename `details` to `X` and `quote` to `q`
  * like `const { details: X, quote: q } = assert;`, so the above example would then be
  * ```js

packages/governance/src/question.js

@@ -41,6 +41,7 @@ const QuorumRule = /** @type {const} */ ({
 const positionIncluded = (positions, p) => positions.some(e => keyEQ(e, p));
 
 /**
+ * @internal
  * @param {QuestionSpec} allegedQuestionSpec
  * @returns {QuestionSpec}
  */

packages/notifier/src/storesub.js

@@ -10,6 +10,7 @@ import { subscribeEach } from './subscribe.js';
 /**
  * NB: does not yet survive upgrade https://github.com/Agoric/agoric-sdk/issues/6893
  *
+ * @alpha
  * @template T
  * @param {Subscriber<T>} subscriber
  * @param {(v: T) => void} consumeValue