From e6b59c812414ec7e00d05dff8c0cc856e5cd81aa Mon Sep 17 00:00:00 2001 From: Pascal Bleser Date: Thu, 22 Jan 2026 14:21:40 +0100 Subject: [PATCH] groupware: also update DEVELOPER.md with new OpenAPI documentation generation tooling --- services/groupware/DEVELOPER.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/services/groupware/DEVELOPER.md b/services/groupware/DEVELOPER.md index 78a415010..6fb9c72a5 100644 --- a/services/groupware/DEVELOPER.md +++ b/services/groupware/DEVELOPER.md @@ -611,10 +611,14 @@ If you run it from your IDE, there is obviously no need to do that. ## API Docs -The REST API documentation is extracted from the source code structure and documentation using [`go-swagger`](https://goswagger.io/go-swagger/), which needs to be installed locally as a prerequisite: +The REST API documentation is extracted from the source code structure and documentation the home-grown [`groupware-apidocs`](https://github.com/opencloud-eu/groupware-apidocs) tool, which needs to be installed locally as a prerequisite: ```bash -go install github.com/go-swagger/go-swagger/cmd/swagger@latest +cd "$OCDIR/" +git clone https://github.com/opencloud-eu/groupware-apidocs +cd ./groupware-apidocs/ +go build . +ln -s "$PWD/groupware-apidocs" ~/.local/bin/ ``` The build chain is integrated within the `Makefile` in `services/groupware/`: