Skip to content

Docs: human test protocol rewritten for the alpha test set, one install page (docs only) - #132

Merged
guijacquemet merged 3 commits into
mainfrom
claude/test-docs-alpha1
Oct 14, 2026
Merged

guijacquemet merged 3 commits into
mainfrom
claude/test-docs-alpha1

Conversation

@guijacquemet

Copy link
Copy Markdown
Contributor

Docs only. Not merged, no tag, nothing published. Based on main 535450d.

What changed

  • docs/HUMAN_TEST_PROTOCOL.md rewritten (404 lines) + per-app case files in docs/human_tests/ (nucleisky, playground, guessthecondition, vlab4mic, celltrackscolab; all < 250 lines).
    • Record sheet 0.1/0.2: Tools tag, template version, Napari/Fiji/QuPath tags, app releases (Playground 0.0.4, NucleiSky 0.1.4, VLab4Mic 0.1.6, GuessTheCondition 0.0.1, all marked planned), download links, OS, tester, date. Rows still <fill in> stop the round.
    • Install rules: no space in path (installers refuse; W1 is now a refusal test, sentence Destination Folder contains 1 space), Linux -u only after a finished install (else delete <prefix>/pkgs), tagged installs only (no main.zip), testers run only the latest.
    • Discovery matrix written as the rule to be (CellTracksColab hidden; GuessTheCondition/Playground/NucleiSky in Napari, Fiji, QuPath; VLab4Mic Napari+Fiji, not QuPath) with the literal sentence discovery rule: see PROTOCOL.md section <TBD by the discovery PR>. PROTOCOL.md/MANIFEST.md untouched.
    • Hosts: Napari with napari[pyqt6] (not pyqt5), Python 3.11+; Fiji jar into Fiji.app/plugins, script+lib zip alternative, pixel-size limit, no "use the image's calibration" button, CAL-T9; QuPath jar, Script Editor needs the single LabConstrictorTools-all.groovy.
    • CellTracksColab is no longer expected in any host; its bridge-test fixtures dependency is gone. Images N14 and F9 (CellTracksColab in a host) removed.
    • NucleiSky pixel sizes now start empty (no default): old expectation of prefilled 0.65/0.325 removed.
  • New docs/INSTALL.md (one install page), linked from README, protocol, REPOSITORIES, OPERATIONS, HOST_FEATURES.
  • TESTING.md: smoke defaults, what the sandbox covers per app/host, PyQt6, Linux -u rule, napari_ref finding. REPOSITORIES.md, HOST_FEATURES.md, README.md, TESTING_PROMPT.md updated. OPERATIONS.md: install section and pin table.

Evidence for the non-obvious claims

Checks run

black, ruff, scripts/check_annotations.py: pass. Relative links and anchors of README and docs/*.md: 0 broken (own script). Doc-reading tests (versions, run-record, features, reserved inputs, conformance, compat): pass except test_installed_metadata_matches_the_source and test_the_built_wheel_contains_..., which fail identically on clean main in this sandbox (environment).

Not verified (written as such in the docs)

See the report in the session: CellTracksColab_LabConstrictor link (replaced by CellTracksColab; old repo unreachable), Linux/macOS path with a space, hosts' behaviour before the discovery rule, helper tools in tool lists, QuPath steps by a person, Fiji/QuPath release assets (none published), Napari tag, release numbers, templates carried by the app releases.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Y2SN8SuEakTdiWy3F2WUqN


Generated by Claude Code

…tall page; true apps, hosts and pins

- HUMAN_TEST_PROTOCOL.md rewritten: test-set record sheet (Tools tag, template, host tags, app releases, links, OS, tester, date), install rules (no space in the path, Linux -u only after a finished install, tagged installs, latest only), discovery matrix as the rule to be, W1 as a refusal test, QuPath as a host, Fiji jar/script zip and its limits, Napari with PyQt6.
- Per-app case files in docs/human_tests/ (NucleiSky, Playground, GuessTheCondition, VLab4Mic, CellTracksColab); CellTracksColab is no longer expected in any host and its bridge fixtures are gone.
- New docs/INSTALL.md (apps and the three hosts); linked from README and the protocol.
- TESTING.md, REPOSITORIES.md, OPERATIONS.md (pin table), HOST_FEATURES.md, README.md updated; CellTracksColab link fixed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y2SN8SuEakTdiWy3F2WUqN
…bers, placeholders

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y2SN8SuEakTdiWy3F2WUqN
@guijacquemet
guijacquemet marked this pull request as ready for review October 14, 2026 06:18
…-alpha1

Resolve docs/REPOSITORIES.md keeping the discovery table and rule line from the
branch and the binding hosts: rule from main; bring TESTING.md, HOST_FEATURES.md,
HUMAN_TEST_PROTOCOL.md and README.md in line with the merged rule and sandbox.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y2SN8SuEakTdiWy3F2WUqN
@guijacquemet
guijacquemet merged commit 641b788 into main Oct 14, 2026
6 checks passed
@guijacquemet
guijacquemet deleted the claude/test-docs-alpha1 branch October 14, 2026 16:08
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