You can read about the swagger specification on the swagger site. Below are some tips on what each swagger object translates to in ReadMe and what additional features we have on top of it! Also make sure your JSON is valid JSON Schema.
To read about how we create these for you based on your swagger file please read: Categories, Pages and Subpages
Your security definitions will be displayed under the authentication modal of your docs.
To read about the extensions that we've added to the Swagger Spec, please read: Swagger Extensions.