acebear17 9475e0e1a4 Docs/design approach 10063 (#10409) ...

* claim: #10063

* docs: add a design approach and workflows chapter to the user guide (#10063)

Adds guide/design-approach.md after the window tour: the parametric idea, principles for designs that change well, the timeline and rollback marker, bodies vs components and occurrences, common workflows with links, a term map for users of other CAD software, and where to find help.

* docs: match the chapter to the app's labels and sketch colours (#10063)

Checked in the web app (0.29.0): the timeline strip is headed History, the toolbar shows New Sketch and Parameters for Create Sketch and Change Parameters, and fully constrained geometry turns white in the default dark theme rather than dark.

* docs: tighten the design approach chapter's wording (#10063)

The glossary covers most, not all, of the chapter's terms; Redo moves forward; the timeline is shown as the History strip; Report a bug drafts a report for the user to file and sends nothing itself.

2026-11-01 02:27:40 +00:00

..

book

Docs/design approach 10063 (#10409)

2026-11-01 02:27:40 +00:00

design

Agent chat: continue after creating or opening a design (#7526) (#9980)

2026-10-31 11:12:00 +00:00

formats

File menu: Export STL… and Export 3MF… open the mesh dialog with that format; command search finds mesh export by format (#3873)

2026-10-20 22:43:30 +00:00

render-materials

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

screenshots

Docs: refresh every UI screenshot, GIF and video from the current UI (#6763)

2026-10-25 19:21:01 +00:00

sponsors

README: Blacksmith sponsor banner (#3287)

2026-10-19 17:45:57 -04:00

3d-mouse.md

3D mouse: optional orbit while a sketch is open (#2227) (#9406)

2026-10-30 19:22:58 +00:00

action-matrix.md

Construction geometry on model vertices follows them when a parameter moves them (#568) (#2409)

2026-10-19 16:11:38 -04:00

agent-chat.md

Assistant: set the reasoning effort per API agent (#10241) (#10259)

2026-10-31 20:48:42 +00:00

ambient-occlusion.md

Viewport: fewer ambient occlusion samples while the view moves (#7165) (#7214)

2026-10-28 15:05:34 +00:00

architecture.md

README: shorter front page; details move to docs (#3275)

2026-10-19 17:23:29 -04:00

assembly-properties.md

Assemblies: mass, centre of mass and inertia per occurrence and rigid group (#9715) (#9717)

2026-10-31 04:35:29 +00:00

blur-behind.md

Blur behind panels: render path, zero cost when off (#8876) (#9809)

2026-11-01 01:37:44 +00:00

browser-api.md

Web: Ctrl+Tab and Ctrl+Shift+Tab switch browser tabs again (#5227) (#5350)

2026-10-23 13:42:27 +00:00

building.md

New designs save as .sc; .solidcraft files still open (#7325)

2026-10-27 22:41:40 +00:00

capabilities.md

New designs save as .sc; .solidcraft files still open (#7325)

2026-10-27 22:41:40 +00:00

chebyshev-motion-trace.md

New designs save as .sc; .solidcraft files still open (#7325)

2026-10-27 22:41:40 +00:00

compatibility.md

New designs save as .sc; .solidcraft files still open (#7325)

2026-10-27 22:41:40 +00:00

configurations.md

Configurations: a design keeps up to 2048 rules (#6221)

2026-10-25 02:29:25 +00:00

contact-sets.md

Drive Joints says where and why a drive stopped short (#1169)

2026-10-14 17:56:21 -04:00

control-protocol.md

Blur behind panels: render path, zero cost when off (#8876) (#9809)

2026-11-01 01:37:44 +00:00

cosmetic-threads.md

Display cosmetic internal and external threads (#2367) (#2868)

2026-10-25 14:53:24 +00:00

crash-reports.md

Report a bug: always offer a way to submit (#5463) (#5615)

2026-10-29 02:43:49 +00:00

design-container.md

Model cache: a design with mesh bodies keeps its saved model (#9170) (#9218)

2026-10-30 16:17:27 +00:00

downloads.md

Release: Arch Linux packages for x86_64 and aarch64 (#8576)

2026-10-29 13:17:34 +00:00

drawing-foundations.md

Drawing: validate section geometry contracts (#2053) (#2085)

2026-10-18 00:29:12 -04:00

drawing-geometry.md

Drawing: validate section geometry contracts (#2053) (#2085)

2026-10-18 00:29:12 -04:00

drawing-hlr.md

Drawings: first landing from the drawings branch (#8249)

2026-10-28 13:31:16 +00:00

face-attachments.md

Profiles and cap attachments fall back to the best match when a sketch outline changes (#2897)

2026-10-19 17:00:55 -04:00

feature-patterns.md

Feature mirrors and patterns: preserve replay and add Flip/Center placement (#1619)

2026-10-16 03:01:00 -04:00

features.md

Regenerate generated files and fold pending files [skip ci]

2026-11-01 00:09:18 +00:00

fonts.md

UI library, tokens, fonts and icons (step 5 of #2016, after #2287)

2026-10-20 21:00:56 +02:00

frames.md

Frames: a Weldments ribbon tab (#4003) (#5262)

2026-10-26 12:24:38 +00:00

hole-presets.md

Personal Hole parameter presets (#4480)

2026-10-26 22:00:56 +00:00

i18n_catalog_ja.md

3D mouse: driver choice, guided calibration, button mapping and a picture of the device (#1463) (#3825)

2026-10-24 03:34:21 +00:00

linked-design-paste.md

Paste saved linked designs at the viewport pointer (#2430) (#2433)

2026-10-19 23:56:48 +00:00

localization.md

Language: follow the system language by default (#10138) (#10183)

2026-10-31 19:50:08 +00:00

manage-ui-kit-audit.md

Redesign the home page as the File view (#2027) (#3822)

2026-10-22 12:19:09 +00:00

mcp.md

Select: resolve faces and edges from a point or index (#10171) (#10191)

2026-10-31 19:11:54 +00:00

mutation-testing.md

Mutation testing: judge kernel mutants by the black-box suites (#2660)

2026-10-18 18:10:36 -04:00

native-brep.md

Display plans and the model cache for large STEP assemblies (#2814) (#4021)

2026-10-21 10:37:12 +00:00

nix.md

Docs: blurry interface on Linux with display scaling, and how to fix it (#5979) (#6195)

2026-10-26 10:24:30 +00:00

occurrence-move-arrows.md

Fix occurrence Move/Copy viewport gizmo input (#3014) (#3015)

2026-10-19 18:07:32 -04:00

occurrence-workflows.md

Undo restores what a hide put away (#2219) (#4780)

2026-10-24 22:12:17 +00:00

oracle.md

Drawings: first landing from the drawings branch (#8249)

2026-10-28 13:31:16 +00:00

perf.md

New designs save as .sc; .solidcraft files still open (#7325)

2026-10-27 22:41:40 +00:00

physical-material-cards.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

picked-face-navigation.md

Find in Browser finds the body; Find in Timeline opens the feature's folders (#3883) (#3884)

2026-10-24 21:53:27 +00:00

plugins.md

Docs: describe SolidCraft as independent CAD (#2768)

2026-10-18 21:16:11 -04:00

point-clouds.md

Point clouds: colour and filter by any property the file carries (#8816) (#8819)

2026-10-30 14:02:29 +00:00

releasing.md

Drawings: first landing from the drawings branch (#8249)

2026-10-28 13:31:16 +00:00

render-aging.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-anisotropic-ggx.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-backends.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-built-in-library.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-clear-coat.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-cpu-advanced-integration.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-cpu-progressive.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-cpu-resource-profiles.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-cpu-workspace.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-denoise.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-environment-sampling.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-environment.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-film.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-finishing-linear-output.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-glass-boundaries.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-glass-shadows.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-gpu-production-envelope.md

New designs save as .sc; .solidcraft files still open (#7325)

2026-10-27 22:41:40 +00:00

render-hdr-input.md

render: bounded cooperative HDR input foundation (#837)

2026-10-13 16:33:51 -04:00

render-hdr-reflections-integration.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-hdr-resources.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-integration.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-jobs.md

Render: reject excessive pixel work during preflight (#5088) (#5728)

2026-10-30 01:35:12 +00:00

render-light-union.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-opaque-pbr.md

Appearance: read the look chain and replace a look everywhere in one undo step (#6428)

2026-10-28 12:10:31 +00:00

render-panels.md

Render workspace UX: roadmap and claim (#6281) (#6282)

2026-10-27 11:46:54 +00:00

render-path.md

GPU path tracer: run on Metal on macOS (#7183) (#7185)

2026-10-29 13:58:49 +00:00

render-portable-surfaces-and-stages.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-primary-aa.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-raytrace-core.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-raytrace-dielectrics.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-raytrace-image.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-runtime-textures.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-settings.md

Render lights: uniform light list, solo and mute, and the Light editor (#6281) (#7265)

2026-10-29 08:40:51 +00:00

render-shot-scene.md

Render shot editor: camera and frame controls, aspect presets, guides and frame overlay (#6281) (#7232)

2026-10-29 07:03:24 +00:00

render-starter-appearances.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-studio-lighting.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-studio-ui.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-surface-emission.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-surface-patterns.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-surface.md

Render: bounded opaque surface contract and numerical BRDF reference (#1019)

2026-10-14 10:00:03 -04:00

render-texture-input.md

render: normalize high precision texture inputs (#1267)

2026-10-15 13:55:35 -04:00

render-texture-interpolation.md

render: add perspective UV interpolation and derivatives (#1461)

2026-10-15 18:04:09 -04:00

render-texture-lod.md

render: add isotropic texture footprint LOD reference (#1460)

2026-10-15 18:55:14 -04:00

render-texture-mips.md

render: add opaque CPU sampling and bounded mip chains (#1459)

2026-10-15 19:39:30 -04:00

render-texture-normalization.md

render: normalize high precision texture inputs (#1267)

2026-10-15 13:55:35 -04:00

render-texture-sampling.md

render: add opaque CPU sampling and bounded mip chains (#1459)

2026-10-15 19:39:30 -04:00

render-thin-lens.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-transmission.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-visual-mapping.md

Render workspace: first basic delivery to main (#6050)

2026-10-24 14:21:58 +00:00

render-vndf-prototype.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

render-workspace-ui.md

Render workspace UX: roadmap and claim (#6281) (#6282)

2026-10-27 11:46:54 +00:00

render-workspace.md

Render: fit the product inside the picture's frame, after the saved setup loads (#5763) (#5764)

2026-10-30 18:30:45 +00:00

ribbon-layout.md

Sketch: equation-driven curve, a curve from x(t) and y(t) formulas (#8352) (#8353)

2026-10-29 17:42:59 +00:00

roadmap-detail.md

Print face: Send to Slicer lays a body on its marked face (#8429) (#8433)

2026-10-30 13:25:18 +00:00

robustness.md

ci: fix local scheduling and Windows test baselines (#4941)

2026-10-24 11:33:10 +00:00

scripts.md

README: shorter front page; details move to docs (#3275)

2026-10-19 17:23:29 -04:00

showcase.md

Docs: refresh every UI screenshot, GIF and video from the current UI (#6763)

2026-10-25 19:21:01 +00:00

sketch-patterns.md

fix: retain circular sketch pattern Quantity expressions (#4435) (#4607)

2026-10-23 13:45:15 +00:00

sketch-tool-panel-review.md

Sketch Chamfer: several corners at once, as Fillet does (#8998)

2026-10-31 19:28:14 +00:00

starter-appearance-pack.md

Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)

2026-10-24 14:21:59 +00:00

step-import.md

Stand-up offer: a note only when the part seems to lie on its back (#7717) (#7718)

2026-10-28 19:40:25 +00:00

theme-colour-audit.md

UI: integrate theme radii, borders, palettes and viewport refresh (#5045) (#5046)

2026-10-23 23:57:34 +00:00

thread-catalogue.md

Tapped Hole: verified metric fine, UNC/UNF and parallel G/Rp catalogues (#4178)

2026-10-24 10:22:57 +00:00

thread-designations.md

Tapped Hole: verified metric fine, UNC/UNF and parallel G/Rp catalogues (#4178)

2026-10-24 10:22:57 +00:00

ui-container-audit.md

Viewport status item: UI-kit element and row (#8544) (#8553)

2026-10-29 03:02:43 +00:00

ui-icon-design-proposal.md

Implement the reviewed UI icon system and durable review workflow (#853)

2026-10-17 04:07:16 -04:00

ui-icon-inventory.md

Implement the reviewed UI icon system and durable review workflow (#853)

2026-10-17 04:07:16 -04:00

ui-icon-maintenance-plan.md

Implement the reviewed UI icon system and durable review workflow (#853)

2026-10-17 04:07:16 -04:00

ui-kit.md

Parameters: show one rename tooltip per name (#10309)

2026-10-31 22:48:33 +00:00

urdf.md

Joints: relations that tie part of a placement (#2497)

2026-10-19 16:08:23 -04:00

view-clipping.md

Viewport: bodies stay visible after switching to perspective and back (#5422) (#5614)

2026-10-25 02:46:59 +00:00

view-dxf.md

Export Current View as DXF includes shown sketches (#3708) (#3780)

2026-10-21 23:09:57 +00:00

web-runtime.md

Roadmap: a short user-facing ROADMAP.md, with the developer detail moved to docs/roadmap-detail.md (#6797)

2026-10-26 06:49:35 +00:00

wip-reconciliation.md

Rename SolveCraft to SolidCraft everywhere, with compatibility shims (#389)

2026-10-12 17:17:01 -04:00