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.
You can access the documentation manager from the Document Library.
ℹ️ Info: The document library lists all the documentation you manage with Scroll in a Confluence space.
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
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.
ℹ️ 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 .
Select an out-of-the-box page template
You are now in the Confluence page editor.
ℹ️ Info: Confluence comes with 100s of templates out-of-the-box. You can even create your own templates.
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 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.
Re-organize your documentation structure
You can easily restructure your documentation by dragging and dropping the articles (pages) in the left navigation bar.
🎉 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
To save a new version, navigate back to the Documentation Manager by following the steps described earlier. Then, click on Save a version.
In the dialog that opens up update the following fields -
Then, click Save.
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.