Merge branch 'docs' into 'main'

Publush API docs

See merge request agx/feedbackd!191

.gitlab-ci.yml

@@ -5,9 +5,9 @@ include:
 
 stages:
   - build
-  - test
+  - test+docs
   - style-checks
-  - package
+  - deploy
 
 variables:
   FDO_UPSTREAM_REPO: agx/feedbackd
@@ -82,7 +82,7 @@ build:clang:native-debian-trixie:full:
 test:native-debian-trixie:
   <<: *image
   <<: *before_script
-  stage: test
+  stage: test+docs
   needs:
     - build:gcc:native-debian-trixie:full
   coverage: '/^\s+lines\.+:\s+([\d.]+\%)\s+/'
@@ -93,8 +93,26 @@ test:native-debian-trixie:
     variables:
       - $PKG_ONLY == "1"
 
+build-doc:
+  stage: test+docs
+  image: ${DEBIAN_IMAGE}
+  variables:
+    BUILD_OPTS: -Dtests=false -Dgtk_doc=true
+  <<: *image
+  <<: *before_script
+  needs: []
+  script:
+    - git clean -dfx
+    - 'echo "Build opts: ${BUILD_OPTS}"'
+    - meson setup ${BUILD_OPTS} _build
+    - meson compile -C _build
+    - mv _build/doc/libfeedback-0/ _reference/
+  artifacts:
+    paths:
+      - _reference
+
 check-consistency:
-  stage: test
+  stage: test+docs
   extends: .phosh-check-consistency
 
 format-check:
@@ -122,3 +140,16 @@ check-commit-log:
       junit: commit-message-junit-report.xml
   rules:
     - if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == $CI_DEFAULT_BRANCH'
+
+pages:
+  stage: deploy
+  needs:
+    - build-doc
+  script:
+    - mv _reference/ public/
+  artifacts:
+    paths:
+      - public
+  only:
+    - main
+

NEWS

@@ -1,7 +1,8 @@
 feedbackd 0.8.5
 ---------------
 Released September 2025
-* Clarify that `important` is meant to override the global app level
+* Clarify that `important` is meant to override the global feedback
+  level not the app's feedback level
 * Add udev rule for FP5 haptic
 * Issues fixed:
     * https://gitlab.freedesktop.org/agx/feedbackd/-/issues/93

README.md

@@ -309,7 +309,7 @@ on IRC and bug tracker.
 
 ## Documentation
 
-- [Libfeedback API](https://honk.sigxcpu.org/projects/feedbackd/doc/)
+- [Libfeedback API](https://feedbackd-b29738.pages.freedesktop.org/)
 - [Event naming spec draft](./doc/Event-naming-spec-0.0.0.md)
 - [Feedback-theme-spec draft](./doc/Feedback-theme-spec-0.0.0.md)
 - [W3's vibration API draft](https://www.w3.org/TR/vibration/)