Scroll Documents introduces the concept of documents to Confluence. This article explains exactly what documents in Confluence are, and when you should use them.
What's a document?
In terms of scope, a document comprises a page and all of that page's descendants:
Essentially, documents are a new scope of content in Confluence that's larger than a page, but smaller than a space. And that's what Documents are best used for – managing documents that contain too much content for a single page, but aren't large enough to warrant their own space.
What can I do with documents?
Of course, this parent/descendant page relationship already exists in Confluence. But the big advantage of creating documents is that you can use Scroll Documents to manage all a document's pages as a single unit of content.
Let me explain using a concrete example – a company handbook with its different sections on different pages:
Normally in Confluence, you couldn't manage this company handbook as a single unit. For example, you wouldn't be able to create versions of, or collect metadata about, the document as a whole – only the individual pages in the document.
However, if you mark the handbook as a document:
you can use Scroll Documents' range of document management features to manage the handbook as one discrete unit of content. For example, you can:
- Version the entire document as one, and view and compare versions
Now you've learned all about what documents are, go ahead and create your first one – either from existing pages, or totally from scratch.