×

Phase Locked Software logoKeep it up to date! Doc

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

Revision: 2024-09-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. That means you can show inactive pages, including the page owner to contact for updates.

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. The table columns are sortable by clicking on the column heading.

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 Keep it up to date! 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 to 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.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 10000 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:

Page labels to include

You can change the list of pages by only including pages with specific labels. In effect, a specific page label is required for a page to be shown in the table.

Show the page Content Status

If this option is set, the macro shows the page content status (if the content status of a published page has been set). See Atlassian Documentation. for more information about the Content Status.

Show the Page Owner

If this option is set, the macro shows the page owner in addition to the last author to update the page.


General Page

You can access the Keep it up to date! general page directly from the top menu under "Apps". This page provides links to the documents where you are the owner and where you are mentioned, and the documentation.

Keep it up to date! general page.

List documents where you are the owner

You can list all documents where you are the owner by going to the General Page and clicking on the button "Show documents where you are the document owner". The resulting table is scrollable and can be sorted by clicking on the column headers.

Keep it up to date! owner table.

List documents where you are mentioned

You can list all documents where you are mentioned by going to the General Page and clicking on the button "Show documents where you are mentioned". The resulting table is scrollable can be sorted by clicking on the column headers.

Keep it up to date! mentions table.


Changelog

The Keep it up to date! changelog is available at Changelog.

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

© 2024  Phase Locked Software