missing files in dist folder

[dukedrake]

Q&A (please complete the following information)

• OS: [e.g. macOS]
  N/A
• Browser: [e.g. chrome, safari]
  N/A
• Version: [e.g. 22]
  N/A
• Method of installation: [e.g. npm, dist assets]
  npm install swagger-ui
• Swagger-UI version: [e.g. 3.10.0]
  3.23.0
• Swagger/OpenAPI version: [e.g. Swagger 2.0, OpenAPI 3.0]
  N/A

Content & configuration

N/A

Describe the bug you're encountering

After installation, the dist folder contains the following files:

.../swagger-ui/node_modules/swagger-ui/dist$ ls -1
oauth2-redirect.html
swagger-ui.css
swagger-ui.css.map
swagger-ui.js
swagger-ui.js.map
swagger-ui-standalone-preset.js
swagger-ui-standalone-preset.js.map

As we learn from the installation documentation:

The module's contents mirrors the dist folder you see in the Git repository. The most useful file is swagger-ui-bundle.js, which is a build of Swagger-UI that includes all the code it needs to run in one file.

However these (essential!) files are missing.

index.html
swagger-ui-bundle.js
swagger-ui-bundle.js.map

After wgetting the raw versions from the Git repo everything is working fine.

To reproduce...

Steps to reproduce the behavior:

1. npm install swagger-ui
2. Go to node_modules/swagger-ui/dist
3. ls
4. See missing files :(

Expected behavior

The files

index.html
swagger-ui-bundle.js
swagger-ui-bundle.js.map

ought to be there.

Screenshots

N/A

Additional context or thoughts

( ... how can this happen at all in the age of sturdy development pipelines? )

[dukedrake]

Ok ... files only exist in swagger-ui-dist module??
As these modules differ in large it might be a good idea to add a small heading to seperate the sections in the documentation?

[shockey]

Reopening to track this as a documentation enhancement request.