From cd5e4d22a1f36ef9ddcbe95061a2ab20d2357ae0 Mon Sep 17 00:00:00 2001
From: Martin Renvoize <martin.renvoize@openfifth.co.uk>
Date: Wed, 29 Apr 2026 10:02:56 +0100
Subject: [PATCH] Bug 29016: (QA follow-up) Document the action_logs list
 controller

Replace the empty =head3 stub with a proper synopsis explaining the URL,
the supported filtering / ordering / embed surface, and the permission
requirement. Aligns the controller with the documentation density of
other Koha REST controllers and removes the "Missing POD" QA noise.

Test plan:
  1. perl -MKoha::REST::V1::ActionLogs -e ''  (still loads)
  2. perl -c Koha/REST/V1/ActionLogs.pm        (still parses)
  3. perldoc Koha/REST/V1/ActionLogs.pm        (renders the new POD)

Signed-off-by: Lucas Gass <lucas@bywatersolutions.com>
---
 Koha/REST/V1/ActionLogs.pm | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/Koha/REST/V1/ActionLogs.pm b/Koha/REST/V1/ActionLogs.pm
index 68c68c8fd2..d3d31283d5 100644
--- a/Koha/REST/V1/ActionLogs.pm
+++ b/Koha/REST/V1/ActionLogs.pm
@@ -29,6 +29,15 @@ use Try::Tiny qw( catch try );
 
 =head3 list
 
+    GET /api/v1/action_logs
+
+Returns a list of action_log entries.
+
+Filtering, ordering, pagination and embeds (C<librarian>, C<patron>) are
+all driven by the standard Koha REST query parameters and the
+C<x-koha-embed> header. Authorisation requires the C<tools.view_system_logs>
+permission.
+
 =cut
 
 sub list {