Niccolò Maltoni

I absolutely agree with you that introducing OpenAPI shouldn't be a breaking change. I think the first step should be introducing the OpenAPI spec only as a manner of documentation...

Hi @Naramsim, I'll answer in points: > Does it make sense documenting our current V2 API with OpenAPI? Yes, I think so: for example, it would help with code generation...

This repo uses a Django server to serve the APIs; I don't know Python at all, so I may be missing something, but after some researches I can say that...

> Actually we use Django REST Framework, which does have some OpenAPI support in the form of plugins That's great! This plugin should be able to be used to generate...

Hi, I tried generating the static schema using [the first suggestion](https://www.django-rest-framework.org/api-guide/schemas/#generating-a-static-schema-with-the-generateschema-management-command) from your link using the environment deployed on Docker with the Docker-Compose you bundle; I put the result on...

Same problem here

Digging deeper on the problem, it seems like that using `mermaid-format: png` or `mermaid-format: svg` to generate the mermaid graphics at rendering time works as a workaround. Please note that...

> We should also consider if each feature can keep sharing the same HTTP and/or HTTPS port(s) (and potentially SSL certificate) or if we should split those options too. @aluccaroni...

Great find @hamadodene, we are getting closer to the solution!

Again, great write-up! Inspecting the provided block, it seems interesting the last part of the `while` loop: ```java CachedContent result = cache.get(e.key); System.out.println("Result at this point is for " +...