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

Before you begin

Make sure you have completed the Getting Started guide before working through this tutorial.

Open the documentation manager

The documentation manager is the command center for managing your documentation with Scroll in your Confluence space.

1

You can access the documentation manager from the Document Library.

  • Navigate to the space that you had created in Getting Started

  • From the left navigation bar under the APPS section, click Scroll Documents

  • Then, click the card titled Product Documentation

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

2

Now you are in the Documentation Manager.

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

To do so, click on the ‘Working version’ link.

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.

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

  • Click the ➕ button 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 .

2

Select an out-of-the-box page template

You are now in the Confluence page editor.

  • Start by adding a page title, e.g. How-to create a new article

  • Then, in the template panel on the right, 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.

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.

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.

5

Re-organize your documentation structure

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

  • Move the How-to articles index page next to the Troubleshooting page.

  • Then, move the How-to create a new 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.

Save a new version of your documentation

1

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

2

In the dialog that opens up update the following fields -

  • Version name - 1.0

  • Description - “First version

Then, click Save.

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.

What’s next?

Learn more from our Guides, Tutorials, Reference articles, or