This guide follows one page through the whole cycle, on the screens you'll actually use — defining sections, writing with Start Working, the review loop, and the dashboard that gathers everything waiting on you.
Three steps from the Marketplace listing to your first tracked page.
Open the Inkwell listing on the Atlassian Marketplace and add it to your Confluence Cloud site. Billing and updates run through your existing Atlassian account, so there is no separate vendor login to manage.
Edit a structured page — a postmortem, PRD, or RFC — type /inkwell, and insert "Inkwell — Section Completion". There is nothing to configure in the editor: publish, and the empty state invites you to add your first section.
Sections and their statuses live on the page itself, in the macro. Your cross-page view lives in Confluence's Apps menu under Inkwell Dashboard — the My Sections list of everything waiting on you.
One full cycle, from empty template to a page that is actually finished.
Click Add First Section and describe the work: a title (up to 200 characters), instructions for the writer (up to 2,000), a required assignee, an optional reviewer — a different person — and an optional due date. Repeat for each section; a page holds up to 50.
The macro becomes the page's status board: a progress bar with the completion count, cards numbered #1, #2, … with status lozenges from Not Started to Approved, and a purple Your Turn marker wherever you are the one holding things up. Overdue sections turn the header red — visible to everyone who opens the page.
Start Working inserts a heading and a "Write here…" placeholder into the page body and opens the editor in a new tab. When the section is written, Submit for Review sends it to the reviewer with an optional note. No reviewer set? The dialog becomes Submit & Mark Complete and approves right away — and if the section body still looks empty, Inkwell warns you before you submit.
The reviewer sees Approve and Request Changes on the card. Requesting changes requires a comment — it lands on the card as reviewer feedback, the status flips to Changes Requested, and the writer answers with Resubmit, optionally noting what changed. Approved sections lock: nobody edits them, so a finished page stays finished.
My Sections gathers everything with your name on it across every page: To work on, To review, Waiting, Done, and Requested by me, with status tiles split by write and review roles and a table sorted by due date. For anything overdue — or due within 24 hours — Inkwell also posts an @mention comment on the page itself, so the nudge reaches people where they already are.
What each choice on a section does.
"Root Cause Analysis" tells a writer where to type; instructions tell them what good looks like. Two minutes spent on the instructions field saves a Changes Requested round-trip later.
Not every section needs a reviewer. Leave the reviewer empty on the routine ones and submitting marks them complete in one step — save the review loop for the sections where a second pair of eyes earns its keep.
Set a due date on the sections that matter and stop chasing people by hand: the page-top bar turns red, cards show Overdue by Nd, and Inkwell posts an @mention comment on the page — before the deadline, and daily after it.
Ask the person who builds it. Replies are fast and specific.