docs: align v0.6.0 release surfaces

Author: scottconverse

MANUAL.md

@@ -422,7 +422,7 @@ Keep using those for cosmetic/visualization parts (bearings, fans, vitamins).
 Swap in tq-threads where you need a *printable* thread rather than a render-only
 one.
 
-### TinkerQuarry / KimCad
+### TinkerQuarry
 MIT is GPL-2.0-compatible, so vendor `tq_threads.scad` into the engine's
 `library/` folder and `include` it from generated `.scad`. The plan→geometry
 step can call presets by name, e.g. `tq_thread_preset("M8", len)` or

README.md

@@ -138,7 +138,7 @@ with anything. Common combinations (full recipes in **[MANUAL.md](MANUAL.md#inte
 |---|---|
 | **BOSL2 / BOSL** | Use BOSL2 for attachments, rounding, and shapes; use tq‑threads for the actual threads. No symbol clashes (`tq_*` vs BOSL2's names). Subtract `tq_thread_cutter()` from BOSL2 solids; the `tq_*` parts are normal children you can `attach()` around. |
 | **Migrating from Dan Kirshner / rcolyer `threads.scad`** | `metric_thread(d,p,l)` → `tq_thread(d,p,l)`; `english_thread()` → `tq_thread_tpi()`; `ScrewThread`/`ScrewHole` → `tq_thread` / `tq_threaded_hole`; `RodStart/RodEnd` → `tq_rod_start/tq_rod_end`. See the [migration table](MANUAL.md#migration). |
-| **TinkerQuarry / KimCad** | MIT → GPL‑2.0 compatible; vendor `tq_threads.scad` into `library/` and `include` it from generated `.scad`. The generator can call presets by name (`tq_thread_preset("M8", …)`). |
+| **TinkerQuarry** | MIT → GPL‑2.0 compatible; vendor `tq_threads.scad` into `library/` and `include` it from generated `.scad`. The generator can call presets by name (`tq_thread_preset("M8", …)`). |
 | **Slicers (Orca/Cura/Prusa/Bambu)** | Export STL/3MF; threads are manifold so no repair step is needed. Print **axis vertical** for best flanks. |
 | **NopSCADlib / hardware libs** | Use their part catalogs for visualization; use tq‑threads when you need a *printable* thread instead of a cosmetic one. |
 

docs/architecture.svg

@@ -5,6 +5,9 @@
 screw threads** — ISO metric and Unified (imperial) — plus the everyday hardware
 built from them: bolts, nuts, washers, tapped/clearance/countersunk holes,
 standoffs, couplers, countersunk and wood screws, and bottle/cap threads.
+The v0.6.0 release also adds flexible printable profile controls: square,
+rectangular, narrow-tooth, groove, `side_angle`, `thread_size`, `lead_ends`, and
+rate-based taper input.
 
 ### What makes it different
 - **Manifold by construction.** Each thread is a single watertight `polyhedron`
@@ -13,6 +16,8 @@ standoffs, couplers, countersunk and wood screws, and bottle/cap threads.
 - **Printable-first.** Fit `clearance`, internal-oversize/external-undersize
   compensation, lead-in chamfers, rounded roots, and real `$fn/$fa/$fs`
   resolution are all parameters.
+- **Flexible profiles.** Keep the default ISO/UN basic profile, or choose
+  full-sharp V, square, rectangular, narrow-tooth, or helical groove forms.
 - **Clean-room + MIT.** Built only from public standards (ISO 68-1/261/262/273/
   4032/4762/7089/10642, ASME B1.1). MIT is GPL-2.0-compatible, so it drops into
   GPL projects unchanged.
@@ -23,6 +28,7 @@ include <tq_threads.scad>;
 tq_thread_preset("M8", 20);                       // M8 rod
 difference() { part(); tq_threaded_hole(6,1.0,12); } // tapped hole
 tq_bolt(8,1.25,20, head="socket", shank=4);       // cap screw
+tq_thread(12,4,20, profile="square", thread_size=1.5);
 ```
 See the [README](../../README.md) for install options and the
 [MANUAL](../../MANUAL.md) for the full reference.

docs/discussions/01-welcome.md

@@ -32,7 +32,22 @@ tq-threads is a clean-room **feature** equivalent (different code + API):
 
 Full table + parameters in the [MANUAL](../../MANUAL.md#migration).
 
-## TinkerQuarry / KimCad
+## v0.6 profile-control notes
+The compatibility default is still `profile="flat"` with the ISO/UN basic
+truncations. New controls are optional and forward through `tq_thread_preset()`
+and `tq_thread_tpi()`:
+
+```openscad
+tq_thread_preset("M8", 20, profile="square", thread_size=1);
+tq_thread_tpi(d=0.5*25.4, tpi=8, length=20, profile="rectangle", rect_ratio=1/3);
+tq_thread(14, 4, 20, profile="square", groove=true, lead_ends="both");
+```
+
+`side_angle=30` is a 60-degree included V using the half-angle-from-perpendicular
+convention. Square, rectangular, and groove profiles are generic printable
+forms, not standards-certified ACME/trapezoidal/buttress replacements.
+
+## TinkerQuarry
 MIT → GPL-2.0 compatible; vendor `tq_threads.scad` into the engine's `library/`
 and call presets by name from generated `.scad`.
 

docs/discussions/02-integrating-and-migrating.md

@@ -22,6 +22,11 @@ Make a bolt **and** its nut with the *same* `clearance` and they fit.
 - Print **axis vertical** for the cleanest flanks; no supports in tapped holes.
 - Keep lead-in chamfers on (default) so threads self-start.
 - `profile="rounded"` for stronger roots on load-bearing parts.
+- For v0.6 generic square/rectangular/groove forms, start with the same
+  `clearance` table, then adjust `thread_size` or `rect_ratio` for printable
+  flank thickness and strength.
+- `fit=` records nominal ISO 965 allowance intent only. On M8 `6g` it is about
+  0.029 mm diametral, so `clearance` is still the practical FDM fit lever.
 - Pitch < ~0.7 mm (fine M2–M3) is at a 0.4 mm nozzle's limit — print slow or use
   a heat-set insert.
 

docs/discussions/03-fdm-tolerance-tuning.md

@@ -4,9 +4,10 @@
 What should tq-threads do next? Vote with 👍 and add your own.
 
 ## On the table
-- **ACME / trapezoidal** lead-screw profile (non-60°).
+- **Standards-accurate ACME / trapezoidal / buttress** lead-screw profiles.
 - **True ISO internal profile** option (vs. the current external-form cutter).
-- **NPT / tapered pipe** threads.
+- **Full NPT / tapered pipe** threads (v0.6 only provides the 1:16 taper-rate
+  reference, not the pipe-thread profile or sealing/gauge behavior).
 - **More named hardware presets** (DIN/ISO bolt & nut length series, helicoil sizes).
 - **Thread-relief groove** helper (undercut at the thread runout).
 - **Knurling** helper for knobs/caps.
@@ -16,6 +17,12 @@ What should tq-threads do next? Vote with 👍 and add your own.
 - Cosmetic/vitamin part libraries — pair with NopSCADlib instead.
 - A GUI configurator.
 
+## Already in v0.6.0
+- Generic printable square and rectangular profiles.
+- Narrow-tooth threads via `thread_size`.
+- Helical grooves via `groove=true`.
+- `side_angle`, `lead_ends`, and `taper_rate=tq_npt_taper_rate()`.
+
 ## Ground rules for contributions
 tq-threads is **clean-room** and **MIT**. New geometry must come from public
 standards + first-principles math, never from another thread library. See

docs/discussions/04-roadmap-and-requests.md

@@ -97,7 +97,7 @@ <h2>Why tq-threads</h2>
       <div class="card"><h3>🖨️ Printable-first</h3><p>Fit clearance, internal-oversize / external-undersize compensation, lead-in chamfers, rounded roots, and real <code>$fn/$fa/$fs</code> are all parameters.</p></div>
       <div class="card"><h3>🔩 Batteries included</h3><p><strong>101 presets</strong> (M1.6–M64 coarse + full ISO 261 fine + UNC/UNF #0–1″), plus bolts, nuts, washers, countersunk &amp; wood screws, augers, Phillips drives, clearance/counterbore/countersink holes, standoffs, couplers, and child‑difference <code>tq_tap</code>/<code>tq_drill</code> wrappers. Square, rectangular, narrow-tooth, and groove profiles are generic printable forms; tune <code>clearance</code> for FDM fit.</p></div>
       <div class="card"><h3>⚖️ MIT licensed</h3><p>Permissive <em>and</em> GPL-2.0-compatible, so it drops into a GPL-2.0-only project (e.g.&nbsp;TinkerQuarry) unchanged.</p></div>
-      <div class="card"><h3>✅ Tested &amp; CI</h3><p>Compile-time preset assertions, split fast/heavy suites, a PowerShell render-proof, and GitHub Actions rendering on every push.</p></div>
+      <div class="card"><h3>✅ Tested &amp; CI</h3><p>Compile-time preset assertions, split render cells, negative/assert tests, independent STL mesh checks, and GitHub Actions running the same proof on every push.</p></div>
     </div>
   </div>
 </section>