-
Notifications
You must be signed in to change notification settings - Fork 37
JSDocs in Wrappers #3361
Copy link
Copy link
Labels
2.0P1Priority 1 (must have): Prevents product teams from adopting/using DS 2.0 as intended at launch.Priority 1 (must have): Prevents product teams from adopting/using DS 2.0 as intended at launch.Tech debtTechnical Debt. Likely no benefit to end users.Technical Debt. Likely no benefit to end users.
Metadata
Metadata
Assignees
Labels
2.0P1Priority 1 (must have): Prevents product teams from adopting/using DS 2.0 as intended at launch.Priority 1 (must have): Prevents product teams from adopting/using DS 2.0 as intended at launch.Tech debtTechnical Debt. Likely no benefit to end users.Technical Debt. Likely no benefit to end users.
Type
Projects
Status
Dev
Info
It would be extremely beneficial to developers using our component wrappers to see better descriptions of properties in components. This would better allow them to stay in their IDE instead of having to switch between IDE and documentation website to figure out what they want to do.
Just a normal comment on a property:

A proper full JSDoc comment on that same property:

As you can see above, with just that one property. It properly gives a description of the property, what type of data it allows for (this can be expanded even further by documenting that type properly as well), whether it's optional or required, and what the default value is so they know.
We only need to create the comments for either Angular or React wrappers, and then have a script to copy them to other set of wrappers.
Acceptance Criteria: