| 1 |
# TikZ-Sections Roadmap |
| 2 |
|
| 3 |
This file tracks remaining work only. Completed features and improvements are |
| 4 |
summarized in [README.md](README.md), with release-level notes in |
| 5 |
[CHANGELOG.md](CHANGELOG.md). |
| 6 |
|
| 7 |
## Near-Term Polish |
| 8 |
|
| 9 |
- [ ] Continue refactoring repeated geometry into internal helper macros: |
| 10 |
- straight segment helpers started for channel and zee |
| 11 |
- rounded corner helpers started for channel and zee |
| 12 |
- lip and stiffener helpers |
| 13 |
- hollow and closed-outline helpers started through the shared box helper |
| 14 |
- mirrored or reversed section helpers |
| 15 |
- [ ] Continue defining the behavior of `simplified` and `detailed` input modes: |
| 16 |
- CFS channel, stiffened channel, zee, and sigma now use simplified mode for |
| 17 |
nominal symmetric `flange`/`lip` input |
| 18 |
- those commands use detailed mode to honor independent top/bottom flange and |
| 19 |
lip dimensions |
| 20 |
- remaining section families still need mode-specific input contracts |
| 21 |
- [ ] Decide what detailed mode means for: |
| 22 |
- CFS bends |
| 23 |
- HRS rolled radii |
| 24 |
- toe radii |
| 25 |
- [ ] Add examples showing simplified and detailed modes after the behavior is |
| 26 |
defined. |
| 27 |
|
| 28 |
## Coordinate And Bounding-Box Standardization |
| 29 |
|
| 30 |
- [ ] Define the public coordinate origin for every section command. |
| 31 |
- [ ] Define a predictable coordinate convention for every section family. |
| 32 |
- [ ] Confirm whether additional public anchor choices are needed. |
| 33 |
- [ ] Document lower-level helper placement expectations. |
| 34 |
- [ ] Verify predictable bounding-box behavior for: |
| 35 |
- plain sections |
| 36 |
- filled sections |
| 37 |
- labeled sections |
| 38 |
- dimensioned sections |
| 39 |
- transformed sections |
| 40 |
|
| 41 |
## API And Parameter Standardization |
| 42 |
|
| 43 |
- [ ] Define canonical parameter names for all remaining section families. |
| 44 |
- [ ] Confirm whether `radius` always means inside bend radius or root radius, |
| 45 |
depending on section family. |
| 46 |
- [ ] Finish CFS input standardization: |
| 47 |
- angle lip naming and direction |
| 48 |
- stiffener length and position naming |
| 49 |
- folded-plate parameter naming |
| 50 |
- optional drawing-style parameters |
| 51 |
- [ ] Continue standardizing HRS inputs: |
| 52 |
- depth |
| 53 |
- width |
| 54 |
- flange thickness |
| 55 |
- web thickness |
| 56 |
- root radius |
| 57 |
- toe radius where applicable |
| 58 |
- [ ] Decide how positional helper commands map to the standardized key-value |
| 59 |
API. |
| 60 |
- [ ] Document public API stability expectations before the first CTAN release. |
| 61 |
|
| 62 |
## Built-Up Sections As TikZ Composition |
| 63 |
|
| 64 |
- [ ] Expand documentation examples for user-composed built-up sections: |
| 65 |
- back-to-back channels started in the rendered manual examples |
| 66 |
- toe-to-toe channels started in the rendered manual examples |
| 67 |
- nested channels started in the rendered manual examples |
| 68 |
- boxed channels started in the rendered manual examples |
| 69 |
- double angles started in the rendered manual examples |
| 70 |
- built-up sections with fasteners started in the rendered manual examples |
| 71 |
- [ ] Show fasteners and welds as ordinary TikZ additions where practical. |
| 72 |
- [ ] Keep built-up command families out of the public API unless a future |
| 73 |
command provides clear value beyond normal TikZ composition. |
| 74 |
|
| 75 |
## Documentation |
| 76 |
|
| 77 |
- [ ] Expand the manual: |
| 78 |
- complete argument tables for all positional commands |
| 79 |
- rendered visual gallery inside the manual |
| 80 |
- clearer notes on lower-level positional helper commands |
| 81 |
- stable release-oriented API reference |
| 82 |
- [ ] Polish example gallery layout: |
| 83 |
- prevent sketch and parameter text overlaps in row-based galleries |
| 84 |
- normalize sketch bounding boxes and scales across examples |
| 85 |
- reduce long-command overfull warnings |
| 86 |
- keep parameter text readable beside each sketch |
| 87 |
- [ ] Add more composed TikZ examples showing: |
| 88 |
- multiple sections in one `tikzpicture` |
| 89 |
- `\draw` |
| 90 |
- `\fill` |
| 91 |
- `\node` |
| 92 |
- `\foreach` |
| 93 |
- nested `scope` transforms |
| 94 |
- labels, dimensions, and custom styling in composed drawings |
| 95 |
- [ ] Explain coordinate origin and bounding-box behavior after those |
| 96 |
conventions are finalized. |
| 97 |
|
| 98 |
## CTAN Submission |
| 99 |
|
| 100 |
- [ ] Use staged version 0.2.0 as the baseline for the first CTAN submission |
| 101 |
candidate. |
| 102 |
- [ ] Review parameter names, coordinate conventions, documentation, and examples |
| 103 |
against CTAN-readiness before upload. |
| 104 |
- [ ] Before submission, choose CTAN topic/category metadata. |
| 105 |
- [ ] Confirm maintainer, license, summary, package description, file layout, |
| 106 |
documentation, and upload archive contents. |
| 107 |
|
| 108 |
## Future Extensions |
| 109 |
|
| 110 |
- [ ] Add thin-walled roof section features: |
| 111 |
- trapezoidal roof sheets |
| 112 |
- corrugated roof sheets |
| 113 |
- standing-seam profiles |
| 114 |
- ribbed decking profiles |
| 115 |
- custom folded roof sheet profiles |
| 116 |
- [ ] Expand concrete drawing features: |
| 117 |
- cross-section stirrup placement around the outside edge of the longitudinal |
| 118 |
bar envelope is now shown for rectangular and circular RC sections |
| 119 |
- default RC styling now uses blue longitudinal bars, red stirrups/ties, and a |
| 120 |
heavier concrete outline |
| 121 |
- beam elevations |
| 122 |
- column elevations |
| 123 |
- slabs |
| 124 |
- walls |
| 125 |
- reinforcement detailing beyond simple cross-sections |
| 126 |
- stirrup/tie spacing along member length |
| 127 |
- [ ] Expand the current `dimensions=true` placeholder into a real |
| 128 |
dimensioning subsystem: |
| 129 |
- channel and zee now use boxed parameter legends for web, flange, lip, |
| 130 |
thickness, and radius labels |
| 131 |
- dimension value labels |
| 132 |
- extension lines and configurable offsets |
| 133 |
- unit formatting |
| 134 |
- ISO-style dimensions |
| 135 |
- AISC-style dimensions |
| 136 |
- AS/NZS-style dimensions |
| 137 |
- Eurocode-style dimensions |
| 138 |
- custom units, labels, arrows, and notation presets |
| 139 |
- [ ] Improve drawing quality: |
| 140 |
- improve geometric consistency across CFS and HRS shapes |
| 141 |
- normalize scale, orientation, and bounding boxes for all section sketches |
| 142 |
- refine bend and rolled-radius drawing behavior |
| 143 |
- improve closed-section fill behavior and line joins |
| 144 |
- add visual regression examples before changing existing shapes |
| 145 |
- review engineering terminology and parameter names against common steel |
| 146 |
section notation |