Zenthas

Documentation

1. What the app does

ReadProof records one confirmation per person and page version. Administrators assign pages to a Confluence group with a deadline; people confirm at the very bottom of the page (ReadProof macro, required tick); when the page changes, everyone confirms the new version. Requires Confluence Cloud and at least one Confluence group.

2. Installation and permissions

Install from the Atlassian Marketplace. The app asks for read access only; it writes nothing into pages and sends no e-mails.

PermissionWhy
Read pages, spacesRead the version of a page and its title for display
Read page treeAssign a whole page tree
Read groupsChoose a group and find its members
Read usersShow names in the overview and exports
App storageStore assignments and confirmations

3. Assign one page

Open Apps → ReadProof (Confluence administrators, ReadProof managers and space administrators for their space; see Roles below). Choose the page, the group and a deadline. Optional: re-confirmation after N days, escalation after N days with an escalation group.

4. Assign a page tree

Choose a parent page and a group. The preview shows how many pages and people are covered. Check it, then confirm. Pages that fail are reported; the rest is assigned.

5. Confirm as a reader

On an assigned page, scroll to the very bottom to the ReadProof box (the author inserts the macro "ReadProof" there). Tick "I have read the whole page and understood it" and click "Read and understood". The page byline only shows your status. The proof (version, date, tick) appears in the CSV and PDF export; admins can switch the required tick off per assignment. This supports the evidence of policy acknowledgement (ISO 27001 awareness, NIS2 training). When the page gets a new version, the confirmation of the old version stays as evidence and you confirm the new one.

6. Read the overview

The overview lists page, group, deadline and "x of y confirmed" and marks overdue assignments.

7. Deadlines and escalation

The Deadlines tab lists overdue people and the number of people to escalate to. The app only lists; it sends no e-mails or notifications. You act on the list.

8. Export

CSV (semicolon-separated, UTF-8) and PDF as downloads. The PDF has a summary and a checksum (names are not part of the checksum). Cells starting with =, +, -, @ are neutralised in the CSV. Exports contain names and account IDs; handle them accordingly.

9. Licence

Sites with up to 10 users use the app for free. Without an active licence (for example an expired trial) only new assignments are blocked (read-only mode); existing assignments, confirmations, overview, deadlines, removal and exports keep working.

Roles. Confluence administrators set up ReadProof and choose the groups of "ReadProof managers" (only they can change this). Managers may assign, report and export on every page; space administrators do the same for their own space; page authors can only request a confirmation for their own page. Everyone else can only confirm. Every request is checked on the server.

10. Known limits

  • Group membership is read when you open or assign; later changes show up the next time.
  • People without a retrievable name show as "(unknown)"; app accounts (bots) are excluded.
  • Tested with 6 pages and 4 people; very large trees are untested.
  • No e-mail reminders. The app does not prove compliance with NIS2 or ISO 27001; it records confirmations.

11. Privacy, deletion, troubleshooting

See the privacy policy. Confirmations are not deleted automatically; export before you remove data. For problems see Support.