Conversation
Feat/mweb 2635 fix
Sync main to stage v2
Deploying swagger-io with
|
| Latest commit: |
2d41994
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://449f444b.swagger-io.pages.dev |
| Branch Preview URL: | https://stage.swagger-io.pages.dev |
kamilpie
approved these changes
Aug 10, 2026
There was a problem hiding this comment.
Pull request overview
This PR consolidates the Swagger Editor documentation by moving the “Swagger Editor Next” content into the primary Swagger Editor page, removes the separate “swagger-editor-next” doc page, and updates the homepage tooling card content.
Changes:
- Replaces
swagger-editor.mdcontent with a much more detailed “Getting started / Development / Docker” guide (SwaggerEditor@5-focused). - Deletes
swagger-editor-next.md(removing the standalone “Swagger Editor Next” docs page). - Updates the homepage card from “Swagger CodeGen” to “Swagger Portal” with new external links.
Reviewed changes
Copilot reviewed 3 out of 4 changed files in this pull request and generated 8 comments.
| File | Description |
|---|---|
| src/content/docs/open-source-tools/swagger-editor.md | Major rewrite/expansion of Swagger Editor docs; merges content previously in the “next” page. |
| src/content/docs/open-source-tools/swagger-editor-next.md | Removes the separate “Swagger Editor Next” documentation page. |
| src/components/Homepage.astro | Updates one homepage card to promote Swagger Portal instead of Swagger CodeGen. |
Suppressed comments (2)
src/content/docs/open-source-tools/swagger-editor.md:193
- Comment grammar: "This alias make sure" -> "This alias makes sure" (same issue as earlier in the file).
// This alias make sure we don't pull two different versions of monaco-editor
src/content/docs/open-source-tools/swagger-editor.md:287
- Markdown code fence is closed with four backticks (````), which will break rendering for subsequent content.
```sh
$ npm run build
</details>
---
💡 <a href="/swagger-api/swagger.io-docs/new/main?filename=.github/skills/code-review/SKILL.md" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Add a `code-review` agent skill</a> or configure MCP servers for context-aware, tailored reviews. <a href="https://docs.github.com/en/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review#mcp-servers-and-agent-skills" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Learn more in the docs.</a>
| @@ -1,190 +1,414 @@ | |||
| --- | |||
| title: Swagger Editor Documentation | |||
| title: SwaggerEditor | |||
| zlib: false, | ||
| }, | ||
| alias: { | ||
| // This alias make sure we don't pull two different versions of monaco-editor |
| ### Usage | ||
|
|
||
| If you have Node.js and npm installed, you can run `npm start` to spin up a static server. | ||
| Use the package in you application: |
| * | ||
| * Alternatively, WASM file can be bundled directly into JavaScript bundle as data URLs. | ||
| * This configuration reduces the complexity of WASM file loading | ||
| * but increases the overal bundle size: |
| ## Security contact | ||
| ### Customization | ||
|
|
||
| - [Plug points](./docs/customization/plug-points/README.md) |
| Now open your browser at `http://localhost:8080/`. | ||
|
|
||
|
|
||
| > **No** custom environment variables are currently supported by SwaggerEditor. |
| path={`${basePath}open-source-tools/swagger-codegen/codegen-v3/about/`} | ||
| optionalPath="https://swagger.io/tools/swagger-codegen/download" | ||
| optionalText="Try Free" | ||
| path='https://support.smartbear.com/swagger/portal/docs/?lang=en' |
Comment on lines
+24
to
+26
| ```sh | ||
| $ npm install swagger-editor@alpha | ||
| ```` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.