From f26fc0d596e3a8cb77add08984efca13d24ce568 Mon Sep 17 00:00:00 2001 From: AJ Isaacs Date: Tue, 27 Oct 2026 09:47:03 -0400 Subject: [PATCH] docs: correct undo, Nest > Edit and job-number references for v0.6.0 - undo-redo: describe the heaviest nests by size instead of job numbers; name the Nest > Edit dialog rather than the internal 'Nest Info' - cutting-planner: clearing lead-ins and cut-offs is now undoable - nest-storage: drop the internal D4 label and the nonexistent Nest > Nest Info menu path --- docs/cutting-planner.md | 2 +- docs/nest-storage.md | 8 ++++---- docs/undo-redo.md | 6 +++--- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/cutting-planner.md b/docs/cutting-planner.md index 803c355f..88b96b18 100644 --- a/docs/cutting-planner.md +++ b/docs/cutting-planner.md @@ -637,7 +637,7 @@ panel is wired in the editor. Non-editor callers still use the shared analyzer. plan keeps locked lead-ins and existing cut-offs unchanged. `Clear Lead-ins & Cut-offs...` asks first, then removes every applied lead-in (locked and hand-placed ones too), every cut-off and the plates' recorded cutting settings, keeping part - poses, order and quantities, and replans from scratch. There is no undo. The button stays + poses, order and quantities, and replans from scratch. To reverse it, close the panel and use Edit > Undo. The button stays enabled while a plan runs: confirming cancels that run, then clears once the cancellation lands (so the plates never change under the planner) and replans. - `Add scrap cut-offs` runs the automatic cut-off planner (defaults 35 in / diff --git a/docs/nest-storage.md b/docs/nest-storage.md index dd236880..5bb47320 100644 --- a/docs/nest-storage.md +++ b/docs/nest-storage.md @@ -29,7 +29,7 @@ The desktop app can save nests two ways: without binding an editable document, and **Download selected version...** saves its exact archived bytes. Select a nest and click **Nest Information...** above the list (or use the - row's right-click menu) to edit the same information as **Nest > Nest Info**, + row's right-click menu) to edit the same information as **Nest > Edit**, including the name, without opening the nest in the main editor. **OK** saves immediately to the same database ID as a new version, then refreshes the list, preview and history; **Cancel** makes no change. The dialog starts with the latest saved metadata. @@ -222,7 +222,7 @@ allocate the year's next name and show it in an editable dialog: OK uploads under the chosen name, Cancel saves nothing. If the check or the allocation fails or takes longer than 3 seconds, the nest uploads under its current name. -In Database mode the name can be edited in **Nest > Nest Info** (it uploads with +In Database mode the name can be edited in **Nest > Edit** (it uploads with the next Save) and in the saved-nest browser's **Nest Information...** (saved immediately). In File mode it stays read-only, since the file name is the nest name. If another active nest already has the exact new name, a warning asks @@ -426,7 +426,7 @@ so the range is drawn faded. Dragging a handle moves it in whole degrees (Shift: 15°) within 0° ≤ start ≤ end ≤ 360°; the end can be dragged past 0° to a full turn. With focus, the arrow keys move a handle and Space switches handles. -When the new details would give the drawing another identity (D4: normalized +When the new details would give the drawing another identity (normalized customer, name, material and grade, exact thickness, units and cut type), Save first looks up active library drawings that already have them and, if any do, names them and asks before saving; a failed lookup also asks. Editing only notes @@ -565,7 +565,7 @@ Add to Release as its only buttons; File > Import BOM stays the familiar way in. are kept: the drawing is stored with a blank material and thickness 0, and the set editor's note column leads to Edit Drawing to fix it before Make Nests. 2. Each drawing is matched to the library (`OpenNest.Data.DrawingSetImport`) by - its identity (D4: normalized customer, name, material and grade, exact + its identity (normalized customer, name, material and grade, exact thickness, units and cut type; the name is the file name without extension, the grade blank, the units the new-nest default and the cut type the one last saved to the library on this PC) and its geometry: diff --git a/docs/undo-redo.md b/docs/undo-redo.md index baf2cf17..e56b112f 100644 --- a/docs/undo-redo.md +++ b/docs/undo-redo.md @@ -28,7 +28,7 @@ Everything stored in the nest: cut-offs; - drawings: import, Shape Library, edit in the converter, drawing properties and quantities, delete, clean unused, Drawing Library adds, a drawing's library link after Save to Drawing Library; -- the nest: its machine and the Nest Info fields other than identity (below). +- the nest: its machine and the Nest > Edit fields other than identity (below). The Edit menu names the step: "Undo Rotate", "Redo Fill". `UndoRecordingTests` holds one test per recorded edit with its label. @@ -43,7 +43,7 @@ Deliberately excluded: and post configuration, nest defaults; - view state: zoom, pan, view toggles, selection, the active side panel; - the nest's identity: `Name`, `Status`, `MadeBy` and `DateCreated`. A restore carries them - over from the live nest, so a Nest Info edit of only these records nothing. All `Document` + over from the live nest, so a Nest > Edit change of only these records nothing. All `Document` state (save path, server id and revision) stays too: the `Document` is never replaced. A save does not clear the history; it marks a save point (`UndoHistory.MarkSaved`, @@ -152,7 +152,7 @@ when it has none does the nest undo. - 50 undo steps and 128 MB per open nest (`UndoHistory.DefaultMaxDepth`, `DefaultMaxBytes`); the oldest states are evicted first, never the current one. - Typical nests take a few kilobytes and a few milliseconds per state. Measured on the - heaviest production nests (E0323-02, 7000 parts; K0924-17, 101 drawings) with every part + heaviest production nests (one of about 7,000 parts, one with 101 drawings) with every part planned: capture about 350 ms and 2.2 MB, Undo about 1 s, most of it the plate reload (`LayoutPart.Create` per part, the same as switching to that plate). Opening a nest pays one capture for the history's first state.