Code Editor

In editing mode, you can switch to the ‘Code’ view from the upper right tab. In this view, the left panel displays a code editor showing the raw contents of the OpenAPI spec, which you can modify directly.

The right panel renders the OpenAPI spec in a traditional Swagger viewer. You can write code and see real-time changes reflected in the preview.

Governance Editor

In editing mode, you can switch to the ‘Governance’ view from the upper right tab. In this view, the left panel shows the original contents of a selected spec which you make changes directly, while the right panel displays governance rule checks for this spec.

You can switch between rule sets using the dropdown menu to see check results for each set. Clicking on entries in the list will navigate you directly to the corresponding line in the spec, allowing you to easily make changes and fix issues.

Diff Editor

In editing mode, you can switch to the ‘Diff’ view from the upper right tab. In this view, the left panel shows the original contents of a selected spec in the git repository, while the right panel displays the current spec with uncommitted changes.

This makes it easy to compare and review what has changed. It’s good practice to use this view before committing your spec changes.

Preview

In editing mode, you can switch to the ‘Preview’ tab from the upper right tab group. In this view, you’ll see how the spec will be rendered in our default spec viewers, which is what you’ll see when you publish an API document or in non-editing mode.