Your space is easier to navigate, if users know where to click to find the information they are looking for. So it all starts with labels. With labels we mean any form of text which especially includes the link text. If users cannot decide by the link text whether or not a click will take them nearer to their destination, add additional text that describes the content the link points to. This is done by short descriptions you are forced to add to all projectdoc documents.

So to enhance navigability add meaningful names and short descriptions to your documents.

Automatic list build upon labels. The help authors to define queries by page properties.

• List all documents with the same parent as this one!
• List all documents tagged with "free" and ("beaver" or "squirrel")!
• List all views on component "X"!

Whenever there is a new document that matches one of these queries, a link will be added automatically to this list. This makes it easier for users to find information to a defined topic. It also makes the work of document authors easier, since the list are always up to date.

The following macros automatically create lists of references:

A tour is a handcrafted list of references to documents. The reason why you prefer the Tour Macro over a simple HTML list is that you can include information from the referenced document very easily.

You may also use a number of display document property macros to reference document properties and render a link to the document.

The following macros help to reference documents by adding document information to the link: