docs/articles/migrating/classic-next.md

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