Skip to content

JSDocs in Wrappers #3361

@ArakTaiRoth

Description

@ArakTaiRoth

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:
Image

A proper full JSDoc comment on that same property:
Image

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:

  1. Give proper full JSDoc comments for every property and event in every component, in either Angular or React
  2. Use AI to duplicate to either Angular or React

Metadata

Metadata

Assignees

Labels

2.0P1Priority 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.

Type

Projects

Status

Dev

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions