Skip to content

Commit 26b2555

Browse files
authored
Update README.md
1 parent bfa7214 commit 26b2555

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@
66

77
**This is the new version of swagger-ui, 3.x. Want to learn more? Check out our [FAQ](http://swagger.io/new-ui-faq/).**
88

9+
As a brand new version, written from the ground up, there are some known issues and unimplemented features. Check out the [Known Issues](#known-issues) section for more details.
10+
911
For the older version of swagger-ui, refer to the [*2.x branch*](https://github.com/swagger-api/swagger-ui/tree/2.x).
1012

1113
## Compatibility
@@ -41,6 +43,14 @@ If you just want to see your specs, open `public/index.html` in your browser dir
4143

4244
If you'd like to make modifications to the codebase, run the dev server with: `npm run dev`.
4345

46+
### Known Issues
47+
48+
To help with the migration, here are the currently known issues with 3.X. This list will update regularly, and will not include features that were no implemented in previous versions.
49+
50+
- Currently, the only configuration options available are the `url` and `spec`.
51+
- The JSON Form Editor is not implemented.
52+
- Shebang URL support for operations is missing.
53+
- Support for `collectionFormat` is partial.
4454

4555
##### Browser support
4656
Swagger UI works in the latest versions of Chrome, Safari, Firefox, Edge and IE11.

0 commit comments

Comments
 (0)