Skip to content

docs: 2.0->2.1 migration guide + release notes (G3, #720) - #755

Merged
jepegit merged 1 commit into
masterfrom
720-migration-guide
Jul 27, 2026
Merged

docs: 2.0->2.1 migration guide + release notes (G3, #720)#755
jepegit merged 1 commit into
masterfrom
720-migration-guide

Conversation

@jepegit

@jepegit jepegit commented Jul 27, 2026

Copy link
Copy Markdown
Owner

The capstone documentation for cellpy 2.1 (Stage 4), written now that Epics A–E have all landed. Closes #720.

What

  • New docs/getting_started/migration_v2.0_to_2.1.md covering every acceptance item:
    • Every Epic E removal with old→new mappings: headers_*schema.* (+ the column-name rename table), ICA shims→ica.dqdv, plotting interactive=/xlim/ylim/summary_plot_legacy + dropped seaborn/bokeh backends, batch_toolscellpy.batch/cellpy.collect, prms.*cellpy.config (with c.mass kept).
    • The batch symbol map (old batch_tools/entry points → new API) + iterate_batches/process_batch recipes.
    • The collectors cross-cell cycle-narrowing bug-fix before/after example.
  • Wired into the Zensical nav ("Coming from cellpy 2.0") and cross-linked from the 1.x→2.x guide.
  • HISTORY.md: a 2.1 (Stage 4) release-notes block under Unreleased.

Accuracy

Every API referenced was verified against the code: CellpyCell.vacant(), summary_plot(c, backend=, x_range=/y_range=), cellpy.collect.collect_summaries/collect_cycles/collect_ica, cellpy.batch load/Batch.from_db/from_journal/combine_summaries, cellpy.config.override. zensical.toml re-validated as TOML; the ../reference/deprecations.md link resolves.

Closes #720.

🤖 Generated with Claude Code

The capstone doc for cellpy 2.1 (Stage 4), describing what shipped now that
Epics A-E have all landed.

- new `docs/getting_started/migration_v2.0_to_2.1.md`: every Epic E removal
  with old->new mappings (headers->schema, ICA shims, plotting knobs +
  dropped seaborn/bokeh backends, batch_tools->cellpy.batch/collect,
  prms.*->cellpy.config with c.mass kept), the batch symbol map +
  iterate_batches/process_batch recipes, and the collectors cross-cell
  cycle-narrowing bug-fix before/after.
- wire it into the Zensical nav ("Coming from cellpy 2.0") and cross-link it
  from the 1.x->2.x guide.
- HISTORY.md: a 2.1 (Stage 4) release-notes block under Unreleased.

All cited APIs verified against the code (CellpyCell.vacant, summary_plot
backend=/x_range=, cellpy.collect.collect_*, cellpy.batch load/from_db/
from_journal/combine_summaries, cellpy.config.override).

Closes #720.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cursor

cursor Bot commented Jul 27, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@jepegit
jepegit enabled auto-merge (squash) July 27, 2026 21:53
@jepegit
jepegit merged commit 53fc2d4 into master Jul 27, 2026
7 checks passed
@jepegit
jepegit deleted the 720-migration-guide branch July 27, 2026 21:56
jepegit added a commit that referenced this pull request Jul 28, 2026
* docs: add 2.0->2.1 migration guide + release notes (G3, #720) (#755)

The capstone doc for cellpy 2.1 (Stage 4), describing what shipped now that
Epics A-E have all landed.

- new `docs/getting_started/migration_v2.0_to_2.1.md`: every Epic E removal
  with old->new mappings (headers->schema, ICA shims, plotting knobs +
  dropped seaborn/bokeh backends, batch_tools->cellpy.batch/collect,
  prms.*->cellpy.config with c.mass kept), the batch symbol map +
  iterate_batches/process_batch recipes, and the collectors cross-cell
  cycle-narrowing bug-fix before/after.
- wire it into the Zensical nav ("Coming from cellpy 2.0") and cross-link it
  from the 1.x->2.x guide.
- HISTORY.md: a 2.1 (Stage 4) release-notes block under Unreleased.

All cited APIs verified against the code (CellpyCell.vacant, summary_plot
backend=/x_range=, cellpy.collect.collect_*, cellpy.batch load/from_db/
from_journal/combine_summaries, cellpy.config.override).

Closes #720.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
(cherry picked from commit 53fc2d4)

* docs: API reference for cellpy.batch and cellpy.collect (G2, #719) (#756)

The 2.1 batch/collect redesign lived in `cellpy.batch` / `cellpy.collect` but
the API reference only documented the `cellpy.utils.*` re-export shims.

- new `docs/api/batch.md` (`cellpy.batch` + facade / journal / aggregate) and
  `docs/api/collect.md` (`cellpy.collect` + summary / curves / ica / collection),
  wired into the Zensical nav and the "Where to look" table.
- `utils.md`: relabel the batch/collectors sections as shims that re-export the
  new packages, pointing at the new pages.

Docstring-generated (mkdocstrings), so it tracks the code. Verified with the CI
docs build (`zensical build --clean`): **No issues found**, 0 warnings — all
referenced modules resolve and links are intact.

Closes #719.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
(cherry picked from commit b6119e2)

* docs: ship cellpy.batch/collect sources for API autodoc on v2-docs-stable

mkdocstrings cannot collect modules that are absent from the docs branch.
Bring the package trees from master so the #756 API pages build.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
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.

G3: migration guide 2.0->2.1 + release notes (write last)

1 participant