Static-Snapshots_logo_2_rgb

How to Make your Confluence Pages Static & Compare them with the SoftComply Static Snapshots app

08 Nov 2021
by Marion
Table of Contents

    Introduction

    With the SoftComply Static Snapshots app you can capture and freeze the dynamic content of your pages in Confluence Cloud. This is something you may want to do to better measure progress over time or to make sure that the content of the pages that need to be approved will not change in the future.

    If you are new to the app, you may also want to read about the use cases of the SoftComply Static Snapshots app or check out a short introductory video about it in our YouTube channel.

    We have just released a new version of the Static Snapshots app where we have improved the UI and added the following new features:

    1. comparison of various snapshots,
    2. exporting of snapshots to pdf format,
    3. adding snapshots as attachments to Confluence pages.

    Below is a longer description about each of these improvements.

    Locking (Static) & Unlocking (Dynamic) Confluence pages

    One of the improvements we have made in the latest release is about simplifying the process of taking snapshots and using these snapshots to create static Confluence pages, i.e. making your Confluence page content static and dynamic, something we call locking and unlocking of the page content.

    The byline menu item of the SoftComply Static Snapshots app now illustrates whether the Confluence page that you are on has dynamic content (is unlocked) or static content (is locked). The SoftComply Static Snapshots app byline menu item on a Confluence page

    You can easily take a snapshot of the page, which stores the static content as a snapshot. You will also be able to use that snapshot to create a new page – “Lock Page with Latest Snap”, making the new version of the page static/locked. Once the page is locked and you go to the edit mode of the page, the page will be unlocked (made dynamic) again.

    The SoftComply Static Snapshots app byline menu item on a Confluence page

    You will also be able to see from the Page History which version of the page is locked (static content) – “page created by the SoftComply Static Snapshots app”.

    Page History illustrates whether a page version has static or dynamic content

    Comparison of the Static Confluence Pages / Snapshots

    One of the new features of the Static Snapshots app is the ability to compare two snapshots between each other.

    There are different places where you can access page comparison (diff viewer) to select the pages and snapshots that you wish to compare.

    You can go either to the app main page (on the left side panel of the page) that will list all the snapshots that have been taken. From there you can choose to compare one snapshot to another from the “Actions” column of the table.

    Compare snapshots from app’s main menu

    Alternatively, you can compare your unlocked (dynamic) page with the latest locked page directly from the byline menu of the page as illustrated below “Compare Page with Last Snap”:

    Access comparison between your unlocked (dynamic) page with the last snapshot from page byline menu

    Once you have chosen to compare two pages, you will have a similar comparison view that is native to Confluence’s page comparison:

    Comparison between snapshots looks like the native Confluence page comparison

    Above the comparison of the content, you will be able to see the IDs of the pages that are being compared, the author of the pages and the timestamp of when the page was created. The comparison follows Confluence’s native page comparison where lines that have been added are marked green and lines that have been removed are crossed out and marked pink.

    Exporting Snapshots to PDF Format

    Exporting snapshots to pdf format is important when you want to store the static page content from a certain point of time in your development lifecycle to add to the records about your product development.

    You can access the export function either from the Static Snapshots app main menu → Actions → Export PDF command:

    Accessing exporting to pdf from app’s main menu

    Alternatively, you can export a snapshot to pdf format from your Confluence page byline menu of the Static Snapshots app → Manage Snapshots → Actions → Export PDF.

    Accessing exporting to pdf from your Confluence page byline menu

    Each pdf export of a snapshot will have the following information in its header: Timestamp (both of the pdf exporting as well as the snapshot creation), Author (both of the pdf export as well as the snapshot creator), and the title of the Confluence page the snapshot was taken of:

    Pdf export of a snapshot with a detailed header

    Exporting Snapshots as attachments to Confluence pages

    Similarly to exporting snapshots to pdf format, you may want to keep the static content of your work as attachments of your product development pages to illustrate the progress of work done over time.

    You can access this exporting feature similarly to exporting to pdf either from the app’s main page → Actions → Add as Attachment command:

    Accessing exporting a snapshot as an attachment from app’s main menu

    Alternatively, you can export a snapshot as an attachment from your Confluence page byline menu of the Static Snapshots app → Manage Snapshots → Actions → Add as Attachment:

    Accessing export as attachment from the Confluence page byline menu

    Once the snapshot is exported as attachment, you will be able to access it from your page Actions menu → Attachments:

    Snapshot added to a page as an attachment

    Learn more about SoftComply Static Snapshots

    Why don’t you give the SoftComply Static Snapshots app a try yourself and let us know what you think!

    Try us out on
    Atlassian

    SoftComply apps are available on Atlassian Marketplace – you can try them all out for free!