Skip to content

docs: expand each algorithm into its own in-depth manual section#4

Merged
jayren3996 merged 1 commit into
mainfrom
docs/expand-algorithm-pages
Jun 1, 2026
Merged

docs: expand each algorithm into its own in-depth manual section#4
jayren3996 merged 1 commit into
mainfrom
docs/expand-algorithm-pages

Conversation

@jayren3996
Copy link
Copy Markdown
Owner

Expands the documentation so each algorithm is its own pedagogical section, following up on the house-style README/logo work.

What changed

  • Split the combined TEBD And TDVP page into separate [TEBD] and [TDVP] pages.
  • Each algorithm now has an in-depth section — TEBD, TDVP, ScarFinder, Operator Space, DMT, DAOE, Chebyshev (CheMPS) — with a consistent template: italic summary → Background (theory + KaTeX math) → how it works in MPSToolkitverified worked example → tips/pitfalls → API (@docs) → example links → references.
  • Architecture expanded into a map of how the algorithms share the evolve! / project! building blocks.
  • Removed a stale orphan evolution.md (not in the nav, superseded).
  • Newly documented MPSToolkit.score, chebyshev_rescaling, rescale_hamiltonian.
  • Updated nav, api.md, README, getting-started, and landing-page links for the split.

Verification

  • Documenter build passes — doctests, cross-references, and KaTeX math all clean; no duplicate @docs (each docstring documented exactly once), no orphan-page warnings.
  • All 7 worked examples were executed against the package and pass (ALL_EXAMPLES_OK). Notably DAOE's damped overlap came out 0.741 = exp(-2γ), matching the documented damping law.

🤖 Generated with Claude Code

Split the combined TEBD/TDVP page and give every algorithm its own pedagogical section (Background with theory + math, how it works in MPSToolkit, a verified worked example, tips/pitfalls, API, example links, references): TEBD, TDVP, ScarFinder, Operator Space, DMT, DAOE, and Chebyshev (CheMPS). Expand Architecture into a map of how the algorithms share the evolve!/project! building blocks, and remove the stale orphan evolution.md.

Coordinate @docs ownership so each docstring is documented exactly once (newly documenting MPSToolkit.score, chebyshev_rescaling, rescale_hamiltonian), and update the nav, api.md, README, getting-started, and landing-page links for the split. All seven worked examples were executed against the package and the full Documenter build passes (doctests, cross-references, KaTeX math).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jayren3996 jayren3996 merged commit cf3766d into main Jun 1, 2026
1 check passed
@jayren3996 jayren3996 deleted the docs/expand-algorithm-pages branch June 1, 2026 11:35
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.

1 participant