Overstappen van Mermaid for Confluence, Swagger UI for Confluence of PowerPlantUML
Deze drie Confluence Cloud-apps draaien nog op Atlassian Connect en zijn niet bijgewerkt sinds Atlassian de updates voor Connect bevroor. Atlassian beëindigt de ondersteuning voor Connect op 31 januari 2027. Specdock is gebouwd op Forge en dekt alle drie: Mermaid-diagrammen, Swagger/OpenAPI-documentatie en PlantUML-diagrammen, op elke pagina.
Welke apps zijn getroffen
| App | Installaties | Laatste update | Vervangen door |
|---|---|---|---|
| Mermaid for Confluence (Tech Labs) | ongeveer 800 | december 2024 | de Mermaid-diagrammacro van Specdock |
| Swagger UI for Confluence (Tech Labs) | ongeveer 650 | april 2025 | de OpenAPI-/Swagger-macro van Specdock |
| PowerPlantUML | ongeveer 430 | mei 2022 | de PlantUML-diagrammacro van Specdock |
Bron: Atlassian Marketplace, gecontroleerd op 14 november 2026.
Overstappen in vier stappen
- Een Confluence-beheerder installeert Specdock via de Atlassian Marketplace (gratis tot 10 gebruikers).
- Open Instellingen → Specdock-instellingen en start de migratiescanner voor een space. Die toont elke pagina die nog een oude Swagger/OpenAPI-, Mermaid- of PlantUML-macro gebruikt, met de tekst van de specificatie of het diagram.
- Typ op elke pagina / en voeg de Mermaid-, PlantUML- of OpenAPI-/Swagger-macro van Specdock toe. Plak de tekst (of verwijs naar dezelfde bijlage, hetzelfde Git-bestand of dezelfde URL).
- Controleer de pagina, verwijder de oude macro en publiceer. Zijn er geen pagina's meer over, verwijder dan de oude app.
Wat je op Forge krijgt
- Draait bij Atlassian: geen externe server slaat je pagina's op.
- Specificaties uit bijlagen, GitHub, GitLab of Bitbucket Cloud (ook privé-repo's), zodat documentatie actueel blijft.
- OpenAPI 3.x, Swagger 2.0 en AsyncAPI, plus een rapport over brekende wijzigingen tussen twee versies.
Vragen
Gaan mijn Mermaid-, Swagger- of PlantUML-pagina's op 31 januari 2027 stuk?
Atlassian beëindigt de ondersteuning voor Connect-apps op 31 januari 2027. Apps die daarna nog op Connect draaien, worden niet meer ondersteund en kunnen stoppen met werken. Is je app niet naar Forge verhuisd, plan dan vooraf de vervanging van de macro's.
Hoe vind ik de pagina's die de oude app gebruiken?
Installeer Specdock, open Instellingen → Specdock-instellingen en start de migratiescanner voor een space. Die toont de pagina's met een oudere Swagger/OpenAPI-, Mermaid- of PlantUML-macro, met de specificatie- of diagramtekst van elke pagina.
Moet ik mijn diagrammen herschrijven?
Nee. Mermaid- en PlantUML-tekst werkt ongewijzigd: kopieer de tekst uit de scanner naar de Mermaid- of PlantUML-macro van Specdock. Wijs bij Swagger/OpenAPI de macro naar dezelfde bijlage, hetzelfde Git-bestand of dezelfde URL.
Draait mijn oude app nog op Connect?
Controleer het met de gratis opzoektool in onze gids over het einde van Connect. Die leest de nieuwste versie van de app uit de Atlassian Marketplace en laat zien of de app op Forge draait, aan het migreren is of risico loopt.
Wat kost Specdock?
Gratis tot 10 gebruikers. Daarboven wordt per gebruiker per maand gefactureerd via Atlassian.
Weet je niet welke van je apps op Connect draaien? Gebruik de gratis opzoektool in de gids over het einde van Connect. Meer over Specdock: documentatie.