REST API swagger documentation

GeoServer GeoServer Developer
1

Hello everybody,

I am doing some improvements on our terraform provider for GeoServer and I would like to use this opportunity to do updates and fixes on the swagger documentation of the API: should I directly update the pages on geoserver/doc/en/api/1.0.0 at main · geoserver/geoserver · GitHub or should I change other files?

Regards
Alexandre

2

Those are the right files, they have been hand-written.
Back at the time we migrated from Restlet to Spring-MVC tools like SpringFox were considered, but I believe they weren’t working properly due to how we generate the XML/JSON payload (hand customized XStream rather than Jackson).

Cheers
Andrea