-
Notifications
You must be signed in to change notification settings - Fork 1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
updated docstrings for BGA packages, needs vetting #231
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've made some comments.
I think in general:
- It is making a lot of mistakes.
- The docstrings that it adds, particularly for
@param
are often not very valuable.
src/landpatterns/BGA/planner.stanza
Outdated
This defines the shape and parameters for the copper, | ||
soldermask opening, paste application, etc. | ||
<DOC> | ||
pad-config:PadConfig with: | ||
default => DEF-PAD-CONFIG | ||
|
||
; GridPlanner Base | ||
doc: \<DOC> | ||
@title pose | ||
@desc Pose of the landpattern (default is loc(0.0, 0.0)) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is the one place where this is interesting and adds value. The default argument for both defstruct fields and function arguments is not an easy thing for us to extract from the definitions database. This might be very useful for extracting the default values into the comments and keeping them up to date.
@callendorph Check out this version. |
No description provided.