Skip to content

Conversation

Maschga
Copy link
Contributor

@Maschga Maschga commented Jul 14, 2025

Fix #844

@Maschga
Copy link
Contributor Author

Maschga commented Jul 14, 2025

In some descriptions, there are multiple Markdown urls.
See /state, for instance:

docs/static/rest-api.yaml

Lines 759 to 763 in 966aba1

description: >
Returns the complete state of the system. This structure is used by the
UI. It can be filtered by [JQ](https://jqlang.github.io/jq/) to only
return a subset of the data. [Read
more.](https://docs.evcc.io/en/docs/reference/configuration/state)

However, externalDocs only allows one url to be provided:
OAI/OpenAPI-Specification#1034

Perhaps we should only make this change once the feature is available.

\cc @andig

@Maschga Maschga changed the title Reat API: use externalDocs Rest API: use externalDocs Jul 14, 2025
@andig
Copy link
Member

andig commented Jul 14, 2025

We could use it where already possible?

@Maschga
Copy link
Contributor Author

Maschga commented Aug 17, 2025

Wie ich mitbekommen habe, hast du mittlerweile die OpenApi Spezifikation ins evcc Repo geholt. Kann dieser PR geschlossen werden, @andig ?

@andig
Copy link
Member

andig commented Aug 17, 2025

Ja, vielen Dank. Sollten wir im main repo schon so haben 👍🏻

@andig andig closed this Aug 17, 2025
@Maschga Maschga deleted the openapi/use-externaldocs branch August 17, 2025 20:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

OpenAPI: investigate simplifying description
2 participants