Create a Scroll document to start managing your documentation in Confluence – Control versions, track changes and manage your content development workflow

Before you begin

What is a Scroll document (a.k.a Document)?

Simply put, a Scroll document (a.k.a document) lives in a Confluence space, and is a container for your documentation page tree and all its versions.

A Scroll document always starts out with a working version and is represented in the form of a card in the Document Library.

What is a Documentation page tree?

A documentation page tree on the other hand refers to the scope of pages within a Confluence space that represent a set of related content that you want to version and manage together.

The Documentation page tree can either be -

  • a single page, or

  • a sub-set of the space page tree, or

  • the entire space page tree

When you create a new Scroll document the documentation page tree is added as the working version of the document.

What is the Working version of a document?
Think of the working version as the continuously progressing version of your documentation. You will use this version to prepare changes to your documentation and save a version once complete.

When you create a new document, you start out by defining a documentation page tree which will be the working version of the document. Later on, you can save more versions to create various snapshots of the working version across multiple points in time.

You can create and manage as many documents and document versions as you need and add metadata to customize and distinguish between the different documents and versions.

Learn how you can create and manage documents and its versions:

Create a Document — Create new documentation or simply enable versioning for existing documentation in Confluence to start tracking changes and managing your content development workflow.
Define and Edit Document Details — Once you have initiated the document creation process, you can add metadata to your document which includes the Document Title, Labels, Summary, and Cover Image. You can also edit all these details after document creation.
Save a Version — Save a version of a document to create a snapshot of the page tree of the document and its content at a certain point in time.
Define and Edit Version Details — Learn about default version details of the Working Version and define the metadata of any subsequent version when you save a version. Edit all details at any point in time after a version was originally saved.
Edit Version Prefix
Overview and Organize Versions — Overview, organize and navigate between different versions of your document.
Manage Restrictions — Control who can view and edit pages in the document’s page trees, and update version details like workflow statuses.
Delete a Document and its Versions — Remove a document or a version you don't want or need anymore.