Skip to content

docs(help): parse-tree help page and graphic announcement - #198

Merged
ddehilster merged 1 commit into
VisualText:mainfrom
ddehilster:docs/parse-tree-help
Jul 26, 2026
Merged

ddehilster merged 1 commit into
VisualText:mainfrom
ddehilster:docs/parse-tree-help

Conversation

@ddehilster

Copy link
Copy Markdown
Member

What

Documents the parse-tree graphic shipped across vscode-nlp 3.10.0 → 3.11.12, and gives parse trees a proper VS Code help page.

New page — vscode/parsetrees.md

Covers the whole subject, both views:

  • Where trees come from — MyText.txt_log/anaNNN.tree and final.tree, plus the four ways to open one (sequence view, Display Final Tree, Display Pass Tree, View selected tree) with keybindings.
  • Reading a tree line — label, char span, pass number, rule line, type, attributes.
  • From the text tree — Highlight text on any node at any depth, Display Rule Fired, Generate @path, Open Pass File, fold/unfold.
  • The graphic — three ways to open it; scroll = zoom, shift+scroll = squeeze/spread, drag = pan, click a phrase node = drill one level, click a word = reveal in text; drill-down default and fit-on-open; per-level overlap-driven label staggering; right-click menu (Reveal Text, Expand/Collapse all below, Center all, Expand all, Collapse all).
  • Working with both views — graph → drill → Reveal Text → Display Rule Fired to land on the rule that needs fixing.

The legacy Using_VisualText/ParseTrees/* pages were left alone: they document the old Windows VisualText GUI (Ana Tab, popup menus, GIF icons), none of which exists in VS Code.

New announcement

vscode/announcements/2026-07-26-parse-tree-graphic.md — introduces the graphic with a screenshot and links to the new page. Picked up automatically by the Help view (date-prefixed, sorts newest-first).

Home

Linked from the Getting started list on vscode/home.md.

Checks

Help/check-help-docs.ps1 — 0 broken links, 0 broken images, 0 table/index drift. (The one orphaned page it reports, New_in_Current_Version, is pre-existing.)

🤖 Generated with Claude Code

Adds vscode/parsetrees.md — a full guide to parse trees in VS Code: where
the .tree files land, how to read a tree line, the text-file right-click
actions (Highlight text on any node, Display Rule Fired, Generate @path,
Open Pass File, fold/unfold), and the parse-tree graphic (three ways to
open it, zoom/pan/shift-scroll controls, drill-down default, per-level
label staggering, and the right-click menu incl. Reveal Text on any node).

Adds an announcement (vscode/announcements/2026-07-26-parse-tree-graphic.md)
introducing the graphic, with a screenshot, linking to the new page.

Links the page from the Getting started list on vscode/home.md.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@ddehilster
ddehilster merged commit 68a6c40 into VisualText:main Jul 26, 2026
1 check 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.

1 participant