mirror of
https://github.com/Redocly/redoc.git
synced 2025-02-01 02:24:08 +03:00
Adds comparison table and OpenAPI link section
This commit is contained in:
parent
8d93021f17
commit
1c8578ea88
58
README.md
58
README.md
|
@ -32,23 +32,53 @@ A version of the Swagger Petstore API is displayed by default.
|
||||||
To test it with your own OpenAPI definition,
|
To test it with your own OpenAPI definition,
|
||||||
enter the URL for your definition and select **TRY IT**.
|
enter the URL for your definition and select **TRY IT**.
|
||||||
|
|
||||||
## Redoc vs. Redocly Reference docs
|
## Redoc vs. Reference vs. Portals
|
||||||
|
|
||||||
Redoc Community Edition is free open-source software (OSS).
|
Redoc is Redocly's community-edition product. Looking for something more?
|
||||||
Redocly has developed extensive enhancements on top of Redoc Community Edition's open core, creating Redocly Reference Docs.
|
Checkout the following feature comparison of Redocly's premium products versus Redoc:
|
||||||
See [Comparison Redoc CE vs. Redocly Reference Docs](https://redoc.ly/redoc-vs-reference/)
|
|
||||||
for the main differences between the Redoc Community Edition and Redocly Reference Docs.
|
|
||||||
|
|
||||||
## Deploy to GitHub
|
| Features | Redoc | Reference | Portals |
|
||||||
[<img alt="Deploy to Github" src="http://i.imgur.com/YZmaqk3.png" height="60px">](https://github.com/Rebilly/generator-openapi-repo#generator-openapi-repo--)
|
|------------------------------|:---------:|:---------:|:-----------:|
|
||||||
|
| **Specs** | | | |
|
||||||
|
| Swagger 2.0 | √ | √ | √ |
|
||||||
|
| OpenAPI 3.0 | √ | √ | √ |
|
||||||
|
| OpenAPI 3.1 | √ (basic) | √ | √ |
|
||||||
|
| | | | |
|
||||||
|
| **Theming** | | | |
|
||||||
|
| Fonts/colors | √ | √ | √ |
|
||||||
|
| Extra theme options | | √ | √ |
|
||||||
|
| | | | |
|
||||||
|
| **Performance** | | | |
|
||||||
|
| Pagination | | √ | √ |
|
||||||
|
| Search (enhanced) | | √ | √ |
|
||||||
|
| Search (server-side) | | | √ |
|
||||||
|
| | | | |
|
||||||
|
| **Multiple APIs** | | | |
|
||||||
|
| Multiple versions | | √ | √ |
|
||||||
|
| Multiple APIs | | | √ |
|
||||||
|
| API catalog | | | √ |
|
||||||
|
| | | | |
|
||||||
|
| **Additional features** | | | |
|
||||||
|
| Try-it console | | √ | √ |
|
||||||
|
| Automated code samples | | √ | √ |
|
||||||
|
| Deep links | | √ | √ |
|
||||||
|
| More SEO control | | | √ |
|
||||||
|
| Contextual docs | | | √ |
|
||||||
|
| Landing pages | | | √ |
|
||||||
|
| React hooks for more control | | | √ |
|
||||||
|
| Personalization | | | √ |
|
||||||
|
| Analytics integrations | | | √ |
|
||||||
|
| Feedback | | | Coming Soon |
|
||||||
|
|
||||||
## Redoc as a service
|
Refer to the Redocly's documentation for more information on these products:
|
||||||
[<img alt="Redoc as a service" src="http://i.imgur.com/edqdCv6.png" height="60px">](https://redoc.ly/workflows)
|
|
||||||
|
- [Portals](https://redoc.ly/docs/developer-portal/introduction/)
|
||||||
|
- [Reference](https://redoc.ly/docs/api-reference-docs/getting-started/)
|
||||||
|
- [Redoc](https://redoc.ly/docs/redoc/quickstart/intro/)
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
- Responsive three-panel design with menu/scrolling synchronization
|
- Responsive three-panel design with menu/scrolling synchronization
|
||||||
- [Multiple deployment options](https://redoc.ly/docs/redoc/quickstart/intro/)
|
- [Multiple deployment options](https://redoc.ly/docs/redoc/quickstart/intro/)
|
||||||
- Deep linking support
|
|
||||||
- [Server-side rendering (SSR) ready](https://redoc.ly/docs/redoc/quickstart/cli/#redoc-cli-commands)
|
- [Server-side rendering (SSR) ready](https://redoc.ly/docs/redoc/quickstart/cli/#redoc-cli-commands)
|
||||||
- Ability to integrate your API introduction into the side menu
|
- Ability to integrate your API introduction into the side menu
|
||||||
- [Simple integration with `create-react-app`](https://redoc.ly/docs/redoc/quickstart/react/)
|
- [Simple integration with `create-react-app`](https://redoc.ly/docs/redoc/quickstart/react/)
|
||||||
|
@ -99,6 +129,14 @@ Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(d
|
||||||
- [APIs.guru](https://apis.guru/api-doc/)
|
- [APIs.guru](https://apis.guru/api-doc/)
|
||||||
- [BoxKnight](https://www.docs.boxknight.com/)
|
- [BoxKnight](https://www.docs.boxknight.com/)
|
||||||
|
|
||||||
|
## Lint OpenAPI definitions
|
||||||
|
|
||||||
|
Redocly's OpenAPI CLI is an open source command-line tool that you can use to lint
|
||||||
|
your OpenAPI definition. Linting helps you to catch errors and inconsistencies in your
|
||||||
|
OpenAPI definition before publishing.
|
||||||
|
|
||||||
|
Refer to [Lint configuration](https://redoc.ly/docs/cli/guides/lint/) in the OpenAPI documentation for more information.
|
||||||
|
|
||||||
## Deployment
|
## Deployment
|
||||||
|
|
||||||
### TL;DR final code example
|
### TL;DR final code example
|
||||||
|
|
Loading…
Reference in New Issue
Block a user