AlaskaAirlines / auro-hyperlink

Custom hyperlink element to connect webpages or data items to one another
https://auro.alaskaair.com/components/auro/hyperlink
Apache License 2.0
2 stars 2 forks source link

Automated API generation is not working as expected #164

Closed blackfalcon closed 1 year ago

blackfalcon commented 1 year ago

Describe the bug

The automated generation of API documentation is no longer working as expected. It is not producing an updated document per API changes.

Verify the version of @aurodesignsystem/auro-hyperlink you have installed

The current version is: See it on NPM!

My project has @aurodesignsystem/auro-hyperlink v3.3.3 installed

To Reproduce

Steps to reproduce the behavior:

  1. Clone this repo if not done alread
  2. Delete the ./docs/api.md file
  3. Run npm run build
  4. See build complete
  5. See no new api. md file is created

Are you able to reproduce this issue on the Auro doc site?

It's a local build issue, not possible to repro on the docsite.

Expected behavior

Builds should generate a new api.md file.

Additional context

The issue comes from the fact that the definition of the element is outside the .js file and managed via the ./index.js file at the root. It is assumed that since the component definition isn't happening in the .js file itself, this is causing WCA to fail.

You can go to the playground and see this happen in real-time. https://runem.github.io/web-component-analyzer/ Comment out the definition of the WC and see the document go blank.