CTrack V6.0 Manual — Phased Migration Plan

Source Analysis

Document Structure

The V5.0 manual has three parts:

PART A — Front Matter (pages 1–23)
  What's New           (9 builds, pages 5–11) → REPLACE with V6-specific changelog
  Ch1 About this manual (pages 13–16, 1 image)
  Ch2 Terms & definitions (pages 17–20, 1 image)
  Ch3 Installation       (pages 21–23, 8 images)

PART B — Users Guide (pages 24–170)
  Ch1 User Interface     (pages 25–43,  41 images)
  Ch2 Configurations     (pages 44–73, 119 images) ← HEAVY
  Ch3 Alignments         (pages 74–101, 138 images) ← HEAVIEST
  Ch4 Live               (pages 102–113, 89 images)
  Ch5 Recorded           (pages 114–165, 157 images) ← HEAVIEST
  Ch6 Database           (pages 166–170, 17 images)

PART C — Reference (pages 171–175)
  Ch7 Advanced info      (pages 171–175, 19 images)

Image Types Identified

From visual inspection of representative pages:

Key insight: ~350 of the 591 images are small icons/buttons embedded in the text. These don't need re-screenshotting — they should be extracted from the V5 PDF and reused, or referenced from a shared icon sprite.

Docusaurus Folder Structure

docs/
├── intro.md                          ← landing page
├── whats-new/
│   └── v6-changelog.md               ← NEW: V6.0-specific changelog (not V5 history)
├── getting-started/
│   ├── about-this-manual.md          ← Part A Ch1
│   ├── terms-and-definitions.md      ← Part A Ch2
│   └── installation.md              ← Part A Ch3
├── user-interface/
│   ├── overview.md                   ← UG Ch1 §1 Introduction
│   ├── toolbar-customization.md      ← UG Ch1 §2
│   └── views.md                      ← UG Ch1 §3 Type of views
├── configurations/
│   ├── overview.md                   ← UG Ch2 §1 Introduction
│   ├── license-and-settings.md       ← UG Ch2 §2
│   ├── hardware-detection.md         ← UG Ch2 §3
│   ├── configuration-detection.md    ← UG Ch2 §4
│   └── adding-elements.md            ← UG Ch2 §5 (large section)
├── alignments/
│   ├── ribbon-bar.md                 ← UG Ch3 §1
│   ├── general-workflow.md           ← UG Ch3 §2
│   ├── measuring-geometries.md       ← UG Ch3 §3
│   ├── manipulating-geometries.md    ← UG Ch3 §4
│   ├── coordinate-systems.md         ← UG Ch3 §5
│   ├── import-export.md              ← UG Ch3 §6
│   └── automation.md                 ← UG Ch3 §7
├── live/
│   ├── overview.md                   ← UG Ch4 §1
│   ├── starting-engine.md            ← UG Ch4 §2
│   ├── logging.md                    ← UG Ch4 §3-4 (combined)
│   ├── stopping-engine.md            ← UG Ch4 §5
│   └── live-modifications.md         ← UG Ch4 §6
├── recorded/
│   ├── overview.md                   ← UG Ch5 §1 (p118-119, 5 images)
│   ├── project-tree.md               ← UG Ch5 §2
│   ├── calculations/                 ← UG Ch5 §3 SPLIT into sub-pages:
│   │   ├── overview.md               ←   Intro + ribbon panel layout (p118-119)
│   │   ├── 3d-6dof.md                ←   Distance, Velocity, Acceleration, Change ref,
│   │   │                                  Virtual markers, Virtual 6DOF, Pose (p120-129, 38 imgs)
│   │   ├── signal-conditioning.md    ←   Offset, Filter, Spike (p130-131, 9 imgs)
│   │   ├── fit.md                    ←   Frequency, Polynome, Function, Doorslam (p132-144, 30 imgs)
│   │   └── trajectory.md             ←   Measured, Nominal, Nominal from CAD,
│   │                                      Compare, Fit spline (p145-151, 24 imgs)
│   ├── data-viewer.md                ← UG Ch5 §4
│   └── exporting-graphs.md           ← UG Ch5 §5
├── database/
│   ├── searching.md                  ← UG Ch6 §1
│   ├── database-management.md        ← UG Ch6 §2
│   └── uncertainty.md                ← UG Ch6 §3
└── reference/
    ├── orientation-conventions.md     ← Ch7 §1
    └── directory-structure.md         ← Ch7 §2

static/img/
├── manual/           ← automated screenshots land here
│   ├── ui/
│   ├── config/
│   ├── align/
│   ├── live/
│   ├── recorded/
│   │   ├── calc-3d-6dof/
│   │   ├── calc-signal/
│   │   ├── calc-fit/
│   │   └── calc-trajectory/
│   └── database/
└── icons/            ← extracted small icons reused across pages

Execution Phases

Each phase follows the same 3-step process:

Step 1: MIGRATE TEXT
  - Extract text from V5 PDF for this chapter
  - Convert to Docusaurus markdown with proper frontmatter
  - Map V5 section numbers to Docusaurus page structure
  - Preserve all technical content verbatim initially

Step 2: VERIFY AGAINST V6 CODEBASE
  - Compare feature descriptions against current C++ source
  - Flag removed features, renamed options, new V6 additions
  - Update text to reflect V6.0 state
  - Mark sections needing screenshot updates with <!-- TODO: screenshot -->

Step 3: REPLACE SCREENSHOTS
  - Use windows-mcp to navigate CTrack V6.0 to each view
  - Capture with screenshot MCP → save to static/img/manual/<chapter>/
  - Update markdown image references
  - For annotated screenshots: add Docusaurus admonitions or HTML markup

Phase 0 — Setup & Icon Extraction

Effort: 1 session | Images: ~350 icons | Pages: 0 docs

Before any chapter work, prepare the foundation:

1. Extract all small icons from V5 PDF

   pdfimages -png Manual_CTrack_V5_0.pdf static/img/icons/icon
   

   Filter by size: keep images < 200×200px as icons, discard the rest (those are screenshots we'll re-capture).

2. Create the folder structure as outlined above

3. Verify MCP servers are running

   • windows-mcp: green in Claude Desktop
   • screenshot MCP: green in Claude Desktop
   • CTrack V6.0 launches and is accessible

4. Create sidebars.js skeleton matching the folder structure

5. Apply CTech Docusaurus theme (use the ctech-docusaurus-style skill)

Claude Desktop prompt for Phase 0:

I'm starting the CTrack V6.0 manual migration. Please:
1. Read the Filesystem to check C:\CTrack-software\Software\V6.0\Docusaurus\
2. Create the docs/ folder structure as defined in the migration plan
3. Create a skeleton sidebars.js
4. Apply the CTech Docusaurus style (you have a skill for this)
Don't create any content pages yet.

Phase 1 — Front Matter: About, Terms, Installation

Effort: 1 session | Images: ~10 | Pages: 3 docs

Lightweight warmup phase to test the full pipeline.

Claude Desktop prompt for Phase 1:

Phase 1: Front Matter migration.

SOURCE: C:\CTrack-software\Software\V6.0\Manual\Manual_CTrack_V5_0.pdf
Pages 13–23 (About this manual, Terms and definitions, Installation)

TARGET: C:\CTrack-software\Software\V6.0\Docusaurus\docs\getting-started\

For each section:
Step 1: Extract the text from the V5 PDF and convert to Docusaurus markdown
Step 2: Flag anything that may have changed in V6.0
Step 3: Take fresh screenshots where the V5 manual had images

Save screenshots to: static/img/manual/getting-started/
Use the Filesystem MCP to write the .md files.

Start with about-this-manual.md and show me the result before continuing.

Phase 2 — User Interface (UG Ch1)

Effort: 1–2 sessions | Images: ~41 | Pages: 3 docs

The UI overview chapter. Moderate complexity — the V5 manual has annotated screenshots showing the ribbon bar, view types, and toolbar customization.

Key V5→V6 changes to verify:

• Ribbon bar layout may have changed (new tabs, reorganized panels)
• View types may include new ones in V6
• Toolbar icons may have been updated

Claude Desktop prompt for Phase 2:

Phase 2: User Interface chapter migration.

SOURCE: Manual_CTrack_V5_0.pdf pages 25–43
TARGET: docs/user-interface/

This chapter has 3 sections:
1. Introduction/Overview (p25-26) → overview.md
2. Toolbar customization (p27-28) → toolbar-customization.md
3. Type of views (p29-43) → views.md

For each section:
Step 1: Extract V5 text → Docusaurus markdown
Step 2: Compare against current CTrack V6.0 UI (use windows-mcp to 
        inspect the actual running application)
Step 3: Capture fresh V6 screenshots → static/img/manual/ui/

The V5 manual uses annotated screenshots with callout labels.
For V6, capture clean screenshots and use Docusaurus features
(admonitions, numbered lists referencing the image) instead of
baked-in annotations.

Start with overview.md.

Phase 3 — Configurations (UG Ch2)

Effort: 3–4 sessions | Images: ~119 | Pages: 5 docs

The first heavy chapter. Dense with dialog screenshots and icon tables.

adding-elements.md is the largest single section. Consider splitting it into sub-pages: input-devices.md, calculations.md, output-devices.md, markers.md, etc. Decide after reviewing the V5 content.

Claude Desktop prompt for Phase 3:

Phase 3: Configurations chapter migration.

SOURCE: Manual_CTrack_V5_0.pdf pages 44–73
TARGET: docs/configurations/

This is a large chapter with 5 sections, the last being 20 pages.
Process one section at a time. For each:
Step 1: Extract V5 text → markdown
Step 2: Verify against V6 codebase — particularly check for 
        new device types, changed dialog layouts, new settings
Step 3: Capture V6 screenshots → static/img/manual/config/

For section 5 (Adding/deleting elements, pages 54-73):
This section is very large. After extracting the text, propose
how to split it into logical sub-pages before proceeding.

Start with overview.md (pages 44-46).

Phase 4 — Alignments (UG Ch3)

Effort: 3–4 sessions | Images: ~138 | Pages: 7 docs

Second heaviest chapter by image count. Geometry measurement workflows.

Key V5→V6 changes to verify:

• New geometry types in V6?
• Trajectory/spline features (added in builds 2560/2626)
• Coordinate system creation workflow changes

Claude Desktop prompt for Phase 4:

Phase 4: Alignments chapter migration.

SOURCE: Manual_CTrack_V5_0.pdf pages 74–101
TARGET: docs/alignments/

7 sections, heaviest are measuring-geometries (7 pages, ~30 images)
and coordinate-systems (8 pages, ~40 images).

For measuring-geometries.md and coordinate-systems.md, these likely
contain sub-sections for each geometry/CS type. Preserve that structure
as ## headings within the doc.

Process one section at a time. After extracting measuring-geometries.md
text, compare against the current CTrack V6 alignment ribbon to check
for new geometry types or changed workflows before taking screenshots.

Start with ribbon-bar.md (page 75).

Phase 5 — Live (UG Ch4)

Effort: 2 sessions | Images: ~89 | Pages: 5 docs

Live measurement workflow. Surprisingly image-heavy for 12 pages — lots of engine state screenshots and DRO views.

Note: This chapter requires a connected tracker to capture meaningful screenshots. Use the CTrack simulation device with a Matlab data file to simulate a tracker during the screenshot automation sessions. Load a representative dataset so that DRO views, graphs, and engine states show realistic values. Prepare the simulation file before starting this phase.

Phase 6 — Recorded (UG Ch5)

Effort: 4–5 sessions | Images: ~157 | Pages: 9 docs

The largest chapter by far. 52 pages covering all post-processing calculations and the data viewer. The calculations section is split into 5 sub-pages by calculation group (matching the ribbon bar grouping).

Session breakdown for Phase 6:

Note: The calculations require recorded data to be present. Use the CTrack simulation device with a Matlab file to record a dataset first, then perform each calculation type to capture the dialogs and results.

Claude Desktop prompt for Phase 6:

Phase 6: Recorded chapter migration.

SOURCE: Manual_CTrack_V5_0.pdf pages 114–165
TARGET: docs/recorded/

The calculations section is split into sub-pages by group:
- calculations/overview.md      (p118-119)  — intro, ribbon panel layout
- calculations/3d-6dof.md       (p120-129)  — Distance, Velocity, Acceleration,
                                               Change ref, Virtual markers, Virtual 6DOF, Pose
- calculations/signal-conditioning.md (p130-131) — Offset, Filter, Spike
- calculations/fit.md           (p132-144)  — Frequency, Polynome, Function, Doorslam
- calculations/trajectory.md    (p145-151)  — Measured, Nominal, Nominal from CAD,
                                               Compare, Fit spline

Screenshots go to: static/img/manual/recorded/calc-3d-6dof/ (etc.)

Start with overview.md (pages 114-116), then project-tree.md (page 117),
then process each calculations sub-page in order.

Phase 7 — Database (UG Ch6)

Effort: 1 session | Images: ~17 | Pages: 3 docs

Short chapter, straightforward.

Phase 8 — Advanced Info & V6 Changelog (Ch7 + What's New)

Effort: 1–2 sessions | Images: ~19 | Pages: 3 docs

The V5 "What's New" section (builds 1685–2626) is NOT migrated. Instead, create a fresh v6-changelog.md that documents:

• What's new in V6.0 compared to V5.0
• New features, removed features, changed behavior
• Source: V6 commit history, code diffs, your own knowledge

Claude Desktop prompt for Phase 8:

Phase 8: Advanced info + V6 changelog.

SOURCE: Manual_CTrack_V5_0.pdf pages 171–175 (Advanced info only)
TARGET: docs/reference/ and docs/whats-new/

1. Migrate orientation-conventions.md and directory-structure.md
   from V5 pages 171-175. Verify paths against V6 directory layout.

2. DO NOT migrate the V5 "What's New" section (builds 1685-2626).
   Instead, create docs/whats-new/v6-changelog.md as a NEW document.
   Use the V6.0 codebase and any release notes to document what
   changed from V5 to V6. Structure as:
   - Breaking changes
   - New features  
   - Improved features
   - Removed/deprecated features

Start with the reference pages, then the changelog.

Phase 9 — Review & Polish

Effort: 2 sessions | Images: 0 new | Pages: all

1. Cross-reference check: all internal links work, all images load
2. Sidebar ordering: verify sidebar_position values make sense
3. Build & preview: npm run build and fix any Docusaurus errors
4. Screenshot quality audit: check all images render at proper size
5. V6 additions: add pages for any V6-only features not in V5 manual
6. Search: verify Docusaurus search indexes all content
7. Landing page: write intro.md with feature overview

Summary

Estimated total effort: ~20 Claude Desktop sessions

Each session = one focused work block of prompting Claude Desktop to execute one phase-step on one chapter section.

Codebase Verification Sources

When verifying V5 text against V6, Claude Desktop should check these source locations using the Filesystem MCP:

Simulation Device Setup (Phases 5 & 6)

The Live and Recorded chapters need a running measurement engine with realistic data. CTrack includes a simulation device that accepts Matlab (.mat) files to simulate a tracker.

Preparation before Phase 5:

1. Load CTrack V6.0 with the simulation device configured
2. Use a representative Matlab data file with 3D + 6DOF data
3. Verify the simulation runs and produces data in the DRO, graphs, and 3D view
4. Record a short dataset to use for Recorded chapter screenshots (Phase 6)

This ensures all screenshots in Phase 5 (Live) and Phase 6 (Recorded) show realistic values instead of empty views.

Session Protocol

For each Claude Desktop session, use this pattern:

I'm working on Phase [N], Step [1/2/3] for [chapter/section].

Source PDF: C:\CTrack-software\Software\V6.0\Manual\Manual_CTrack_V5_0.pdf
Pages: [start]–[end]

Target: C:\CTrack-software\Software\V6.0\Docusaurus\docs\[path]\[file].md
Screenshots: C:\CTrack-software\Software\V6.0\Docusaurus\static\img\manual\[chapter]\

[Specific instructions for this session]

Show me results before writing files.