8.1 KiB
8.1 KiB
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 |
| Collaborative Space | Workspaces | Projects, Organizations, and Teams |
| Billing | Individual Billing | Individual Billing, Organization Billing, and Fair Billing Policy |
| Swagger Extensions | Not supported | Supported |
| Change History | Basic Commit History | Full Commit History Backed by Git |
| Project Visibility | Private Projects | Private and Public Organizations and Projects |
| Guest Role | Guests (read-only) count towards your team size | 50 Guest limit that doesn't count towards your team size |
| Ref Builder | Not supported | Supported |
| Access Tokens | Not supported | Supported |
| Code View | Not supported | Supported |
Modeling
| Stoplight Classic (v2) | Stoplight Next (v3) | |
|---|---|---|
| Shared Specification | Traits | Shared Models and Parameters |
| Grouping | Grouping | Hubs Ref Builder |
| Documentation Design | Modeling | Hub |
| API Discovery | Supported | Coming Soon |
| Bulk Editing | Supported | Code View Editor |
Hubs
| Stoplight Classic (v2) | Stoplight Next (v3) | |
|---|---|---|
| Documentation Produced | API Reference | API Reference, Supplementary Documentation, and Auxillary Documentation |
| Linking | SRN | Markdown |
| Routes | Slug | Markdown |
| 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 |
| Workflow | Creation through Modeling | Standalone Documentation Tool (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 |
| Javascript Runtime | API | API |
| Prism Command Line | Commands | Commands Changed |
Scenarios
| Stoplight Classic (v2) | Stoplight Next (v3) | |
|---|---|---|
| Testing | Not Available | Integrated into the platform |