Skip to content

docs: add missing Synopsis/Usage blocks to ball_bearings, shapes3d, metric_screws (#90)#1956

Open
junhinhow wants to merge 3 commits intoBelfrySCAD:masterfrom
junhinhow:fix/doc-correctness-90
Open

docs: add missing Synopsis/Usage blocks to ball_bearings, shapes3d, metric_screws (#90)#1956
junhinhow wants to merge 3 commits intoBelfrySCAD:masterfrom
junhinhow:fix/doc-correctness-90

Conversation

@junhinhow
Copy link
Copy Markdown

Summary

  • Add missing Usage blocks to ycyl() and zcyl() in shapes3d.scad (matching existing xcyl() pattern)
  • Add missing Usage blocks to ball_bearing() and ball_bearing_info() in ball_bearings.scad
  • Add missing Synopsis to 14 functions/modules in metric_screws.scad

Test plan

  • All modified files parse correctly in OpenSCAD
  • Documentation blocks follow BOSL2 format conventions
  • No code logic changes, documentation only

Addresses #90

🤖 Generated with Claude Code

Both functions had documentation headers but were missing the
required Usage sub-block. Added Usage patterns following BOSL2
documentation format, placed after See Also and before Description.

Ref: BelfrySCAD#90
Both functions had documentation headers but were missing the
Usage sub-block. Added Usage patterns matching the existing xcyl()
documentation format for consistency.

Ref: BelfrySCAD#90
All public functions and modules in metric_screws.scad had
documentation headers but were missing the Synopsis sub-block
required by openscad-docsgen.

Added Synopsis lines to:
- get_metric_bolt_head_size/height()
- get_metric_socket_cap_diam/height/socket_size/socket_depth()
- get_metric_iso_coarse/fine/superfine_thread_pitch()
- get_metric_jis_thread_pitch()
- get_metric_nut_size/thickness()
- generic_screw() module
- metric_nut() module

Ref: BelfrySCAD#90
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant