Debian Codegraph @

texmf-dist/doc/latex/tikz-sections/ROADMAP.md

raw
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