×

Phase Locked Software logoKeep it up to date! Doc

Keep it up to date! Logo Keep it up to date!
Documentation

Revision: 2023-01-09

What is worse than no documentation? Outdated documentation!

Keep it up to date! is an application that lists pages that have not been updated for a while.

Keep it up to date! is free to use by everyone who wants to use it, but there is also very limited support ;-)

User Documentation

By listing pages which have not been updated, Keep it up to date! facilitates Confluence document management best practices. Confluence content lifecycle tools are not included in Confluence out of the box.

By listing pages not updated since a specific period, content archiving is simplified and traceable. This allows you to find outdated information automatically.

List outdated page in an overview table, and directly click on the linked page to update the page.

If there are outdated pages, The pages are shown in an overview table.

When no pages are found, a message is shown.

If there are no outdated pages, a message is shown.

Using the Document Metadata macro

Simply insert Keep it up to date! inline in your document by typing "/keep" when you are editing your document. A dialog as shown below will appear, allowing you tin insert the macro.

Inserting the macro with the shortcut /keep

Configuration and settings

Once added to a page in confluence, there are a few settings you can change

While editing the page, select the macro and go to the settings by clicking the pencil button in the popup

Edit the macro by clicking on the 'pencil' symbol.

This opens a settings dialog:

The settings dialog of the addon.

Maximum amount of pages displayed

This one speaks for itself. By default there are max 10 pages shown in the list, with the page that has not been updated the longest at the top.
You can change the maximum from 1 to 50 pages.

Only show pages that are older than this amount of days

It doesn't make much sense to focus on pages that were only updated a couple of days ago. Therefore you can set a threshold of how outdated pages can become.
Best set it to a couple of months worth of days. This setting defaults to 150.

The Confluence space to check for outdated pages

Also pretty straightforward. Select the space to check for outdated pages. If no space is selected, the space of the page that you are adding the macro on is chosen.
Currently it is not possible to retrieve the list of most outdated pages of all spaces.

Note that if you check the box of the next setting, the space configured is ignored.

Restrict to descendants of this page

If this option is set, the macro only looks at all the children, and their children, and their children, etc.

Page labels to ignore

There are only a few scenario's when a page shows up in the list of outdated pages:

Print query url

You don't have to use this, but it displays the API url that is built up using the settings.

Please note that returned pages by this API call are filtered using 'older than days' setting, so keep this in mind when the macro does not show pages, but the API response does.


Data security statement


Overview

The Keep it up to date! add-on helps with keeping documents in Confluence updated. Data transport is secured using TLS (Transport Layer Security).

No authentication details are used by this macro, all information is retrieved client side and no Confluence data are stored or used server side.

Data storage

The add-on server does not store data. It does not store any data from your Confluence instance, including users, pages, or anything else. All of the data generated by the add-on is only visible during usage of the addon and never sent to Phase Locked Software's servers.

Backups

The add-on server, which only stores the add-on itself is automatically backed up by our hosting provider. In addition we keep offsite backups for disaster recovery.

Privacy

All transactions are secured using HTTPS. Because no user data is stored, there is no long-term privacy risk to using this add-on.

Logging

We keep logs in order to audit for possible security incidents and other errors.

Installing the add-on

You can install Keep it up to date! Logo Keep it up to date! for Confluence Cloud from the Atlassian Marketplace. Click the "Get it now" button to get started.


Keep it up to date! Logo Keep it up to date! for Confluence Cloud

Sitemap

Contact

© 2023  Phase Locked Software