Skip to content

Template 0.1.40: editorial pass on seven guides - #64

Merged
guijacquemet merged 4 commits into
mainfrom
claude/stardist-labconstrictor-plan-aizdd6
Nov 18, 2026
Merged

guijacquemet merged 4 commits into
mainfrom
claude/stardist-labconstrictor-plan-aizdd6

Conversation

@guijacquemet

Copy link
Copy Markdown
Collaborator

From the third (editorial) audit:

  • notebook_portability: a concrete opening (colleagues in JupyterLab, reviewers in Colab) instead of a generic benefit list; "As you can see…" is gone.
  • before_getting_started: the six brochure sections become two paragraphs. The prerequisites, the token line and the 0.1.39 distribution.platforms sentence are kept.
  • external_code_upload: the opening is an action (a package under src/ with __init__.py). "Good to know" becomes "Limits and options".
  • code_hiding: a direct opening.
  • install: app users no longer see hosts: or YAML detail; the page links the image-software guide.
  • workflow_status: the "paste the whole log into ChatGPT, Gemini or Claude" advice is now: read the failed step first; an AI assistant can help, but remove tokens and private paths first; check the fix and rerun.
  • tools_bridge: "Apps that declare no tools are not affected." moved into "What the installer does".

Every anchor that other pages link to is kept.

Migration 0.1.39 → 0.1.40 (these seven files):

  • A file is replaced whole only when it is the copy the template last shipped; otherwise it is SKIPPED with a by-hand note.
  • External_code_upload is handled with the app's package name.
  • code_hiding and notebook_portability were changed in October without a migration, so apps older than that get SKIPPED on those two pages, with a note.

Tests: tests/_v0_1_40.py, plus test_template_sync_0_1_40.py (16 tests). Locally the full suite (551 tests), mypy and ruff 0.15.20 pass.


Generated by Claude Code

notebook_portability: one concrete sentence instead of the benefit list, plainer instructions.
before_getting_started: the six feature sections become two paragraphs (prerequisites, token
and distribution.platforms sentence kept). external_code_upload: the action (a package under
src/ with __init__.py), "Good to know" -> "Limits and options". code_hiding: plain intro.
install: no hosts:/yaml detail for app users. workflow_status: privacy-aware advice on asking
an AI assistant. tools_bridge: "Apps that declare no tools" moves to the installer section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WX6rdRdA72nsUjZvTXFSbP
v0_1_39_to_v0_1_40.py replaces seven guides of .tools/docs whole, only when the app's copy is
still the template file last shipped (LF comparison, the app's line endings kept, SKIPPED with
a by-hand note otherwise, nothing created or deleted). external_code_upload.md is also
recognised with the app's package name. Resources: the new pages and previous/ (the 0.1.39
pages). Design note migration_0_1_40.md (not listed in the index).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WX6rdRdA72nsUjZvTXFSbP
…0_1_40.py)

before_0_1_40 gives the frozen 0.1.39 copy of a guide that is the 0.1.40 page; it is chained
into before_0_1_39, and the 0.1.39 tests use it where they read a live guide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WX6rdRdA72nsUjZvTXFSbP
Resources are the live guides and differ from the frozen 0.1.39 copies; a 0.1.39 app reaches
the live guides (LF and CRLF kept) and a second run changes nothing; a customised guide is
SKIPPED with its by-hand note; external_code_upload.md with the package name; missing files
are not created; a file that is not text is kept; sync.py from 0.1.39 and the chain from
0.1.38. Also checks the edited passages, the anchors other pages link to and the relative links.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WX6rdRdA72nsUjZvTXFSbP
@guijacquemet
guijacquemet merged commit 411e6db into main Nov 18, 2026
4 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.

2 participants