Skip to content

docs: cover shared/tie, pool, and varying on the composed approach page - #27

Merged
seabbs merged 2 commits into
mainfrom
docs/composed-approach-shared-pool-varying
Aug 13, 2026
Merged

seabbs merged 2 commits into
mainfrom
docs/composed-approach-shared-pool-varying

Conversation

@seabbs-bot

Copy link
Copy Markdown
Collaborator

What

Adds coverage of three ComposedDistributions features that the composed-distributions approach page did not describe, weaving them into the existing structure rather than restructuring it.

  • shared / tie — complete pooling. New "Tie a parameter across branches" section. shared(:name, leaf) is the leaf-local spelling and tie(tree, paths...; name = :name) is the tree-level spelling of the same tie, giving one value everywhere a name appears.
  • pool — partial pooling. Added to the existing "Uncertainty in the parameters themselves" section, framing shared/tie (complete) → pool (partial) → independent uncertain specs (none) as a pooling spectrum. pool(:group, population) is a spec passed to uncertain as a keyword.
  • varying — non-stationary leaves. New "Non-stationary leaves" section covering varying, has_varying, instantiate, and Context.
  • Added tie to the "Parameters and edits" verb list under "Four layers" to keep it representative.

Verification

All API named in the new prose was verified against the registered ComposedDistributions v0.1.1 by running each call in a fresh project with the registered packages. threshold was deliberately avoided as it is not exported in v0.1.1.

Closes #20

This was opened by a bot. Please ping @seabbs for any questions.

seabbs-bot and others added 2 commits August 10, 2026 12:27
Add coverage of three ComposedDistributions v0.1.1 features the composed
approach page did not describe: complete pooling with shared/tie, partial
pooling with pool inside uncertain, and non-stationary leaves with varying,
instantiate, and Context. All API verified against the registered v0.1.1.

Closes #20

Co-authored-by: Sam Abbott <contact@samabbott.co.uk>
Split the run-on pool sentence and use a consistent :group label in the
generic signature and the worked example.

Co-authored-by: Sam Abbott <contact@samabbott.co.uk>
@github-actions

Copy link
Copy Markdown

📄 Site preview built

The rendered site for this PR is available as the site-preview artifact on this run. Download it and open _site/index.html to review.

@seabbs
seabbs merged commit cebd22a into main Aug 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Composed distributions approach page does not mention shared/tie, pool, or varying

2 participants