Change Swagger-UI -> Swagger UI in docs (#5479)
* Change Swagger-UI -> Swagger UI in docs * Changed back to SwaggerUI in places that refer to JS construct
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
### Prior art
|
||||
|
||||
Swagger-UI leans heavily on concepts and patterns found in React and Redux.
|
||||
Swagger UI leans heavily on concepts and patterns found in React and Redux.
|
||||
|
||||
If you aren't already familiar, here's some suggested reading:
|
||||
|
||||
@@ -17,7 +17,7 @@ In the following documentation, we won't take the time to define the fundamental
|
||||
|
||||
### The System
|
||||
|
||||
The _system_ is the heart of the Swagger-UI application. At runtime, it's a JavaScript object that holds many things:
|
||||
The _system_ is the heart of the Swagger UI application. At runtime, it's a JavaScript object that holds many things:
|
||||
|
||||
- React components
|
||||
- Bound Redux actions and reducers
|
||||
@@ -27,11 +27,11 @@ The _system_ is the heart of the Swagger-UI application. At runtime, it's a Java
|
||||
- References to the React and Immutable.js libraries (`system.React`, `system.Im`)
|
||||
- User-defined helper functions
|
||||
|
||||
The system is built up when Swagger-UI is called by iterating through ("compiling") each plugin that Swagger-UI has been given, through the `presets` and `plugins` configuration options.
|
||||
The system is built up when Swagger UI is called by iterating through ("compiling") each plugin that Swagger UI has been given, through the `presets` and `plugins` configuration options.
|
||||
|
||||
### Presets
|
||||
|
||||
Presets are arrays of plugins, which are provided to Swagger-UI through the `presets` configuration option. All plugins within presets are compiled before any plugins provided via the `plugins` configuration option. Consider the following example:
|
||||
Presets are arrays of plugins, which are provided to Swagger UI through the `presets` configuration option. All plugins within presets are compiled before any plugins provided via the `plugins` configuration option. Consider the following example:
|
||||
|
||||
```javascript
|
||||
const MyPreset = [FirstPlugin, SecondPlugin, ThirdPlugin]
|
||||
@@ -43,7 +43,7 @@ SwaggerUI({
|
||||
})
|
||||
```
|
||||
|
||||
By default, Swagger-UI includes the internal `ApisPreset`, which contains a set of plugins that provide baseline functionality for Swagger-UI. If you specify your own `presets` option, you need to add the ApisPreset manually, like so:
|
||||
By default, Swagger UI includes the internal `ApisPreset`, which contains a set of plugins that provide baseline functionality for Swagger UI. If you specify your own `presets` option, you need to add the ApisPreset manually, like so:
|
||||
|
||||
```javascript
|
||||
SwaggerUI({
|
||||
@@ -54,7 +54,7 @@ SwaggerUI({
|
||||
})
|
||||
```
|
||||
|
||||
The need to provide the `apis` preset when adding other presets is an artifact of Swagger-UI's original design, and will likely be removed in the next major version.
|
||||
The need to provide the `apis` preset when adding other presets is an artifact of Swagger UI's original design, and will likely be removed in the next major version.
|
||||
|
||||
### getComponent
|
||||
|
||||
@@ -62,7 +62,7 @@ The need to provide the `apis` preset when adding other presets is an artifact o
|
||||
|
||||
All components should be loaded through `getComponent`, since it allows other plugins to modify the component. It is preferred over a conventional `import` statement.
|
||||
|
||||
Container components in Swagger-UI can be loaded by passing `true` as the second argument to `getComponent`, like so:
|
||||
Container components in Swagger UI can be loaded by passing `true` as the second argument to `getComponent`, like so:
|
||||
|
||||
```javascript
|
||||
getComponent("ContainerComponentName", true)
|
||||
|
||||
Reference in New Issue
Block a user