Update links in README to use editor-next.swagger.io & update reference to CAMARA API Guideline

[maxl2287]

What type of PR is this?

Add one of the following kinds:

• subproject management

What this PR does / why we need it:

Changes the usage of viewing Swagger-UI via editor-next.swagger.io

Fixes #325

[hdamker]

The PR is fine for me, but I have not the impression that using the next-editor from Swagger is a general solution.
a) the link isn't working as expected for me (not showing the YAML in the left panel when loading)
b) the next editor is an alpha version
c) a own hosted version of Swagger UI, maybe utilizing GitHub pages or on camaraproject.org might be the better solution

[maxl2287]

The PR is fine for me, but I have not the impression that using the next-editor from Swagger is a general solution. a) the link isn't working as expected for me (not showing the YAML in the left panel when loading) b) the next editor is an alpha version c) a own hosted version of Swagger UI, maybe utilizing GitHub pages or on camaraproject.org might be the better solution

@hdamker on our side at DT, some of us faced the issue, that the "normal" editor.swagger.io was not working as expected anymore.
I tried with editor-next and there were no issues on my side

But I can also investigate or we can try to find a general solution in Commonalities.

[hdamker]

But I can also investigate or we can try to find a general solution in Commonalities.

I might fit better into Tooling, have created camaraproject/tooling#8 as a start. And yes, the problem was observed by others as well.

With the now merged links it looks for me like this - left panel is not loading the code:

[maxl2287]

But I can also investigate or we can try to find a general solution in Commonalities.

I might fit better into Tooling, have created camaraproject/tooling#8 as a start. And yes, the problem was observed by others as well.

With the now merged links it looks for me like this - left panel is not loading the code:

Oh ... okay.
That's weird. I'll investigate.

[maxl2287]

@hdamker maybe this is an issue on swagger editor, why I changed it to editor-next.
I faced exactly this issue here:

swagger-api/swagger-editor#5484

That's why I changed it to editor-next.
But at the time when I faced this issue, I did not saw someone complaining on their github-issues site.

[hdamker]

@hdamker maybe this is an issue on swagger editor, why I changed it to editor-next. I faced exactly this issue here:

swagger-api/swagger-editor#5484

That's why I changed it to editor-next. But at the time when I faced this issue, I did not saw someone complaining on their github-issues site.

It was mentioned in some meetings and e.g. here: https://camara-project.slack.com/archives/C05SH6QDWP7/p1745834520529549. I hoped that is a temporary problem.