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.
| Permission | Why |
|---|---|
| Read pages, spaces | Read the version of a page and its title for display |
| Read page tree | Assign a whole page tree |
| Read groups | Choose a group and find its members |
| Read users | Show names in the overview and exports |
| App storage | Store 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.