Backlog uses cookies to deliver our services. By visiting our website, you agree to the use of cookies as described in our Cookie Policy.

Keeping your page structure organized is important for making its information useful.

Let's revise our example page's structure to make sure information is easy to find.

Make multiple pages

So far in this tutorial, we've only made a single page called “Test”. Besides “Home” and “Test”, Backlog provides another three default templates: “Requirements Template”, “Retrospective Template” and “Status Update Template”. Right now, you should have five pages.

Make the following pages, referring back to the “Adding a page[g]” section if you need to. The contents of these pages isn't important (it's okay if they just say “XXXX”, for example). We'll use these pages in the rest of the tutorial.

  • Leave applications
  • Using the attendance management system
  • Expense claims
  • Printer settings
  • Meeting room reservations

When you're done adding pages, the right-hand sidebar should look like the following image.

Adding a table of contents to the home page

As the number of pages in your wiki increases, it becomes difficult to find the information you need from the page listing alone.

Adding a guide on the home page will help new Wiki users find information for themselves. Copy and paste the following content to the “Home” page.

Markdown notation

# Initial setup
New employees should check this page before performing initial setup.

* [[Using the attendance management system]]
* [[Printer settings]]

# Regular duties
Anyone who doesn't understand how to use the duties system should check the procedural manual here.

* [[Leave applications]]
* [[Expense claims]]
* [[Meeting room reservations]]

Backlog notation

* Initial setup
New employees should check the following pages before performing initial setup.

- [[Using the attendance management system]]
- [[Printer settings]]

* Regular duties
Anyone who doesn't understand how to use the duties system should check the following procedural manuals.

- [[Leave applications]]
- [[Expense claims]]
- [[Meeting room reservations]]

In this example, we have helped new employees to see that they should first read the “Using the attendance management system” and “Printer settings” pages.

Using hierarchies to group pages

For organizations with a large number of pages and contributors, editing the home page like this may be too difficult.

Some Wiki services (including Backlog) have a feature to configure parent-child relationships between pages.

Let's use this feature to group similar pages together. In Backlog, separating page names with a “/” (slash) establishes a parent-child relationship between those pages.

Separate the pages we added earlier into two groups: “Initial setup” and “Regular duties.” Change the page names to the following.

Pre-change page name Post-change page name
Leave applications Regular duties/Leave applications
Using the attendance management system Initial setup/Using the attendance management system
Expense claims Regular duties/Expense claims
Printer settings Initial setup/Printer settings
Meeting room reservations Regular duties/Meeting room reservations

Now we don't need to enter the name of each page on our home page.

Copy and paste the following into your Home page.

Markdown notation

# Initial setup

New employees should check this page before performing initial setup.

# Regular duties

Anyone who doesn't understand how to use the duties system should check the procedural manual here.

Backlog notation

* Initial setup

New employees should check the following pages before performing initial setup.

* Regular duties

Anyone who doesn't understand how to use the duties system should check the following procedural manuals.

Once you're done, the home page and right-hand sidebar should appear as follows. Now we can get an overview of the entire Wiki by looking at the page list without having to edit the home page.

Now you can note particularly important pages on the home page, and search for all other pages using the page list.

Group using tags

Some Wiki services have a feature to add tags to pages. Tags are short snippets of text that describe a page.

On Wiki services with tags, you can use tags, rather than a hierarchical structure, to group pages together.

Let's try grouping our pages using this feature. In Backlog, we can set up tags by enclosing text in square brackets (i.e. “[ ]”) before the page name.

Each page can only have one parent page, but each page can have several tags.

Both “Leave applications” and “Using the attendance management system” are related to attendance, so let's tag both of them with “Attendance”. Change the page names to the following.

Pre-change page name Post-change page name
Regular duties/Leave applications [Attendance]Regular duties/Leave applications
Initial setup/Using the attendance management system [Attendance]Initial setup/Using the attendance management system

Tagged pages show their tags underneath the page name. The right-hand sidebar also shows a list of the tags used on this Wiki. “Attendance (2)” indicates that there are two pages tagged with “Attendance” on this Wiki.

Clicking the above tag will display all pages tagged with “Attendance”.

If grouping pages hierarchically proves too tedious, grouping them with tags can be more effective. However, as you accumulate tags, it can become difficult to determine which tag to use. It's worth trying to keep the number of tags you use as low as possible.