Scroll for Confluence

Scroll Content Manager: Manage Versions, Variants, and Translations of Your Content

In this tutorial, you will learn how to add a new page to your documentation, use page templates, re-organize the structure your content, and then save a new version of your documentation.

Scroll Content Manager for Confluence

Scroll Content Manager introduces advanced content management features to Confluence, complete with version management and change tracking. Scroll Content Manager can also be extended to enable you to define and manage variants and translations of your documentation so you can deliver the right content to various audiences.

In this tutorial, we’ll focus on the base functionality of Scroll Content Manager and help you get started with versioning. Before you begin, please ensure you have Scroll Content Manager installed. You can confirm this by navigating to your space and locating the “Scroll Content Manager” entry under the Apps section on the left navigation bar.

Prepare your sample documentation

Scroll Content Manager offers an out-of-the box Product Documentation template that we will use to test the app.

1

Navigate to the space where your documentation lives or where you’re comfortable testing the app.

ℹ️ Info: We highly recommend creating a new blank space before proceeding.

question mark Don’t have the permission to create a new space? Choose any existing space that you may have access to.

Scroll Documents Prepare your sample documentation 1.png

2

Next, click Scroll Content Manager the navigation bar.

Then click New documentCreate from template.

New document option selected within the Document Library


3

Select Product Documentation Next.

Product Documentation template selected as document template


4

Add a document title, then leave the default values as is.

Click Save.

Document details dialog, showing input fields for metadata including the document title, summary, and document owner.


5

Once the documentation is created click Working version.

Document Manager open with one Working version


6

Feel free to click around the different articles to see how topics in your documentation can be created and organized in Confluence.

Product documentation article in the Confluence page view, containing a tips panel with some dummy text


Open the documentation manager

The Document Manager is the command center for managing your documentation with the Scroll Apps in your Confluence space.

1

You can access the Document Manager from the Document Library.

  1. Navigate to the space where your documentation lives or where you’re comfortable testing the app

  2. From the navigation bar click Scroll Content Manager

  3. Then, click the card titled Product Documentation

ℹ️ Info: The Document Library lists all the documentation you manage with Scroll in a Confluence space.

Document Library with one document inside


2

Now you are in the Document Manager.

Before we save a new version, we’ll first edit the Working version of the documentation.

To do so, click Working version

Document Manager open with one Working version

Edit the working version of your documentation

1

Add a new article to your documentation

You are now in the Working version of your documentation. We will start by adding a new How-to article to the documentation.

  1. Hover your mouse pointer over the Product Documentation page in the left navigation bar under Pages.

  2. Click Create ➕to add a new page.

ℹ️ Info: 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. Think of your versions as snapshots of your Working version .

Product documentation article in the Confluence page view, containing a tips panel with some dummy text

2

Select an out-of-the-box page template

You are now in the Confluence page editor.

  1. Start by adding a page title, e.g. How to article

  2. Then, in the template panel, search for and select the How-to article template.

ℹ️ Info: Confluence comes with 100s of templates out-of-the-box. You can even create your own templates.

Confluence page editor showing the How-to article template selected, with placeholder content and the template configuration sidebar visible.


3

Add content to the article and publish it

The template comes with a pre-defined structure and some instructional text.

Feel free to edit the content and explore the editor options.

But, for now, you can can simply hit Publish.

The How-to article template has been applied to a new Confluence page, containing step-by-step instructions and a related articles placeholder.


4

The new page is now created and added at the bottom of your documentation page tree.

You will also notice that an additional page titled How-to articles was automatically created. This page is called an index page and is automatically added by Confluence when you create a new page from an out-of-the-box page template.

This page lists all the pages created with the How-to article template in the Confluence space.

How to template published as Confluence page


5

Re-organize your documentation structure

You can easily restructure your documentation by dragging and dropping the articles (pages) in the left navigation bar.

  1. Move the How-to articles index page next to the Release Notes page.

  2. Then, move the How to article page below the How-to articles page.

🎉 Congratulations! You have successfully updated the working version of your documentation.

➡️ Next you will save a new version of your documentation.

how-to-article-moved-in-page-tree.png


Save a new version of your documentation

1

To save a new version, navigate back to the Document Manager by following the steps described earlier. Then, click Save version.

Document Manager open with one Working version

2

In the dialog, update the following fields:

  • Version: 1.0

  • Description: “First version

Then, click Save.

Save version dialog in showing V1 entered in the version name field


3

Wait until you see a success message at the bottom-left of the screen saying - Version created.

🎉 Congratulations! You have successfully created the first version of your documentation, and in the process learned how to create and edit new pages, use out-of-the-box templates, and re-organize your documentation structure in Confluence.

Document Manager view, showing the active Working Version alongside one saved version in the version list


Create and manage variants and translations

In addition to saving versions, you’re also able to create variants and translations of your documentation and publish this content to your users. With Scroll Content Manager alone, these feature sets are limited to 2 variants and 2 languages per document. Should your team need more than this, you can install the extension apps.

Here is where you can access the Variants and Translations features:

1

From the Document Manager of your document, select Settings.

This is where you can access the Variants and Translations functionality.

Document Manager open with one Working version

2

Variants let you define content that is only shown under specific conditions. This is particularly helpful when you want to control the scope of content that gets published.

Learn more about creating and managing Variants here →

Variant settings, featuring the option to add a variant.


3

Translations enable you to localize your content and deliver your document in any of the languages it has been translated into.

Learn more about creating and managing Translations here →

Translations settings, featuring the option to activate translations.


Scroll Content Manager: What’s next?

Saving versions is only the beginning. Scroll Content Manager offers a host of powerful features that will transform the way you create and manage your documentation. Please visit Scroll Content Manager’s app documentation to get the most of out of the app. For example:

  • Track and Review Documents: Keep an overview of changes to your documentation over time. View document activity, compare changes, and set and track workflow states.

  • Deliver and Publish Documents: Find a publishing workflow that works best for your team.

  • Manage Variants or Translations of your content: Deliver the right documentation to the right audience, even in the language they need it.

Scroll Apps: Let’s Continue

Version management: Check! check mark Dive deeper into the Scroll Apps to learn how to publish your documentation – along with its versions, variants, and translations – with the rest of the Scroll Apps: