Compare commits
2 Commits
develop
...
rowa97-pat
| Author | SHA1 | Date | |
|---|---|---|---|
|
5f6175bb5d | ||
|
|
887ff05a8c |
54
articles/migrating/classic-next.md
Normal file
54
articles/migrating/classic-next.md
Normal file
@@ -0,0 +1,54 @@
|
||||
# Stoplight Classic to Stoplight Next Migration Notes
|
||||
|
||||
## Platform
|
||||
|
||||
| | **Stoplight Classic (v2)** | **Stoplight Next (v3)** |
|
||||
| :---------------------- | :---------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
||||
| **File Types** | RAML and YAML | YAML |
|
||||
| **Commits** | Basic Commit System | [Platform backed by Git, all files are Git Repos and have full Git commit support](/platform/projects/git-repo) |
|
||||
| **Collaborative Space** | Workspaces | [Projects](/platform/projects/creating-a-project), [Organizations](/platform/organizations/create-org), and [Teams](/platform/organizations/teams/create-team) |
|
||||
| **Billing** | Individual Billing | [Individual Billing](/platform/getting-started/billing/plans-overview), [Organization Billing](/platform/getting-started/billing/organization-plan-overview), and [Fair Billing Policy](/platform/getting-started/billing/fair-billing) |
|
||||
| **Swagger Extensions** | Not supported | Supported |
|
||||
| **Change History** | Basic Commit History | [Full Commit History Backed by Git](/platform/editor-basics/change-history) |
|
||||
| **Project Visibility** | Private Projects | [Private and Public Organizations and Projects](/platform/projects/visibility) |
|
||||
| **Guest Role** | Guests (read-only) count towards your team size | [50 Guest limit that doesn't count towards your team size](/platform/getting-started/billing/fair-billing) |
|
||||
| **Ref Builder** | Not supported | [Supported](/documentation/referencing-other-data-sources) |
|
||||
| **Access Tokens** | Not supported | Supported |
|
||||
| **Code View** | Not supported | [Supported](/platform/editor-basics/read-design-code-view) |
|
||||
|
||||
## Modeling
|
||||
|
||||
| | **Stoplight Classic (v2)** | **Stoplight Next (v3)** |
|
||||
| :----------------------- | :------------------------: | :---------------------------------------------------------------------------------------------: |
|
||||
| **Shared Specification** | Traits | [Shared Models and Parameters](/modeling/modeling-with-openapi/shared-parameters-and-responses) |
|
||||
| **Grouping** | Grouping | [Hubs Ref Builder](/documentation/referencing-other-data-sources) |
|
||||
| **Documentation Design** | Modeling | [Hub](/documentation/introduction) |
|
||||
| **API Discovery** | Supported | Coming Soon |
|
||||
| **Bulk Editing** | Supported | [Code View Editor](/platform/editor-basics/read-design-code-view) |
|
||||
|
||||
## Hubs
|
||||
|
||||
| | **Stoplight Classic (v2)** | **Stoplight Next (v3)** |
|
||||
| :------------------------- | :------------------------: | :------------------------------------------------------------------------------------------------------------------------------: |
|
||||
| **Documentation Produced** | API Reference | API Reference, Supplementary Documentation, and Auxillary Documentation |
|
||||
| **Linking** | SRN | Markdown |
|
||||
| **Routes** | Slug | [Markdown](/documentation/getting-started/routing) |
|
||||
| **Hiding Models** | Supported | Coming Soon |
|
||||
| **Authentication** | Basic Auth and OAuth 2.0 | [Basic Auth, Auth0, OAuth 2.0, and SAML with multiple security scheme support](/modeling/modeling-with-openapi/security-schemes) |
|
||||
| **Workflow** | Creation through Modeling | [Standalone Documentation Tool](/documentation/introduction) (Hubs) |
|
||||
| **Custom Domain** | Email Support | Automated |
|
||||
|
||||
## Prism
|
||||
|
||||
| | **Stoplight Classic (v2)** | **Stoplight Next (v3)** |
|
||||
| :--------------------- | :------------------------------------------------------------------: | :----------------------------------------------------------: |
|
||||
| **HTTP Requests** | Logs HTTP Requests | Coming Soon |
|
||||
| **Prism Instances** | Every version supported by Mock Server and Proxy Server | [Unlimited amount of Prism Instances](/mocking/introduction) |
|
||||
| **Javascript Runtime** | [API](https://help.stoplight.io/prism/runtime-reference/api) | [API](/mocking/javascript-runtime) |
|
||||
| **Prism Command Line** | [Commands](https://help.stoplight.io/prism/getting-started/commands) | Commands Changed |
|
||||
|
||||
## Scenarios
|
||||
|
||||
| | **Stoplight Classic (v2)** | **Stoplight Next (v3)** |
|
||||
| :---------- | :------------------------: | :---------------------------------------------------: |
|
||||
| **Testing** | Not Available | [Integrated into the platform](/testing/introduction) |
|
||||
Reference in New Issue
Block a user