You want to avoid headaches and wasted time when editing continuously maintained pages? Whether you want to quickly and intuitively write down a few meeting notes, update a changelog, or simply edit pages - Confluence offers a lot of possibilities. There are several solutions with Atlassian Apps that can help you. With most apps it is possible to design your own templates. But it is always necessary to switch into page edit mode. Therefore in this blog we’ll show you two effective examples to avoid editing:

First Option:

For example, to stay within the basic functions of Confluence, you could update a changelog using the comment function. This avoids unnecessary editing. This can be done smoothly while viewing the page instead of unnecessarily going into page edit mode. In the long term though, this might lead to a very confusing Confluence site and it is not possible to build in own templates to keep the structure smooth. The comment editor is also limited to a subset of the functionality that you would have in your actual Confluence page - for example you can’t use inline tasks in comments.

comment-section
Changelog in comment section

Second Option:

The Atlassian Marketplace App: Diary for Confluence.

This option allows you to add a comment box anywhere on a Confluence page. To show you how easy it is to use Diary in your Confluence, the following section describes how to use it.

Look-and-Feel
Diary Design

If you want to use the Diary, start by inserting a new Diary macro into your page using either the { }-syntax or the macro browser.

marco-syntax
Diary Macro

To show and edit the Parameters, click on your Diary macro and then choose Edit

Macro Parameters for your own Diary

Once you clicked the Edit button, a dialog will open which allows you to set all the macro parameters.

paramter-adjusting
List of Parameters

Order of Entries: You can determine the order of the entries yourself. You can have either the newest entry or the oldest entry displayed at the top.

Diary Style: Here you can choose the style in which the diary is displayed. These two styles are available:

  • Simple: This design is meant to be simple and compact.
  • Bubble: If you want it to be fancy, you can choose the “speech bubble design“.
Diary Design Simple
Simple
Diary Design Bubble
Bubble

Position of Editor: Here you can choose where the editor for new entries will appear. There are 3 options to choose from:

  • Top: Select at “Order Of Entries”: Newest Entry First
  • Bottom: Select at “Order Of Entries”: Oldest Entry First
  • Hidden: If you don’t want people to add new entries to the diary, you can disable the editor by choosing this option.

Show Diary Title: Here, you can choose whether you want the title of the Diary to be displayed. By default this is off. If you activate the checkbox, you will also be able to set the title of the diary.

Templates: Once a template is created on your Confluence page, Diary can access it. So you can easily use your predefined layout with every new entry. (If you want to know how templates are made click here.)

Creating an Entry

There are two ways to create a new entry for your Diary:

  • Using the shortcut for writing a new entry. (Press d)
  • Clicking on the entry box.

As we embedded the Confluence editor into the Diary you are able to use inline tasks, userlinks, macros and everything else the editor offers, just as if you would be using the normal page editor.

Once you are done you have two options to save your entry:

  • Using the shortcut for saving an entry. (Press ctrl+s)
  • Clicking on the save button.

This was pretty quick and easy, wasn’t it? If you remember the shortcuts you can save even more time.

Editing an Entry

The Diary has a feature which allows you to easily edit the content of your entries while viewing the page. Simply hover over the entry you want to edit and click on the pencil icon.

As entries are just ordinary page content you can actually edit them using the page editor too! To enter page edit mode press “e” or click on the Edit button in the top right hand corner of your page. In here you can not only edit the content of your entries, but also their date and time as well as their authors.

Deleting an Entry

Diary has a feature which allows you to easily delete your entries while viewing the page. Simply hover over the entry you want to delete and click on the trash can.

Just like with editing entries you can of course also delete them by using the page editor.

The easiest way to do this is by clicking into the row that you want to delete and then removing it by clicking this button.

Conclusion

These were two ways to make editing of changelogs, meeting notes and other recurring tasks quick and easy without having to edit the whole Confluence page. Which possibility will make more sense for you depends on your working method and tasks.