Overview Of Page Hierarchies

Searching Help

Question:
I've noticed in playing around w/ Confluence, all pages are created at the same level - directory level? - whether I create all pages as peers, or whether I create nested pages. What are the pros/cons of creating all pages as peers vs. using a nested structure? Can you help us understand what the best practice would be in creating a lot of wiki content.

All the pages within one space will have the same url prefix no matter if it is a child page or root page
yourspace:page1 will have url http://wikis.sun.com/display/yourspace/page1
if you have a second page that is a child (nested page) of the page1, let's call it page2, the url will look like this: http://wikis.sun.com/display/yourspace/page2

Why is this so and why should you care about nesting the pages then? For a couple of reasons:

  • the url is "flat", so then you can change the nesting without breaking urls
  • breadcrumbs, children macro and other macros use the parent/child relationships and show the pages as a tree hierarchy, e.g.
    • breadcrumb for yourspace:page1 will be Wikis Home > yourspace > page1
    • breadcrumb for yourspace:page2 will be Wikis Homo > yourspace > page1 > page2

By doing this you can organize your content into trees that are very easy for users to navigate

  • page level permissions (restrictions) apply to the page and all of its children, so if you set the permissions so that only sun employees can modify page1, the same rule will automatically apply to page2
  • you can move a page and all of its children to a different space or under another page in the same space - this makes it super easy to reorganize even big spaces.
  • in the future we hope that it will be possible to set a watch on a page and all of its children - there is a JIRA request for this functionality, at the moment a watch watches only the page that it was set on

There might be some other advantages that I missed

More information about "page families" can be found here: http://confluence.atlassian.com/pages/viewpage.action?pageId=139543

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Sign up or Log in to add a comment or watch this page.


The individuals who post here are part of the extended Sun Microsystems community and they might not be employed or in any way formally affiliated with Sun Microsystems. The opinions expressed here are their own, are not necessarily reviewed in advance by anyone but the individual authors, and neither Sun nor any other party necessarily agrees with them.

Copyright 1994-2009 Sun Microsystems, Inc.
Powered by Atlassian Confluence
Sun Guidelines on Public Discourse Privacy Policy Terms of Use Trademarks Site Map Employment Investor Relations Contact