Versions Compared

Old Version 8

changes.mady.by.user S Venkatakrishnan

Saved on

compared with

New Version 9

changes.mady.by.user S Venkatakrishnan

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Before adding any content to the wiki take a look at the content tree structure at http://cwiki.apache.org/confluence/pages/listpages-dirview.action?key=TUSCANY and identify a node in the tree where the content could best fit.  To start with you could identify if the content falls under general or under a specific subproject or under a specific implementation of a subproject.  Then under this you could further categorize if the content is to do with 'Technical Documentation' or 'Release' and so on.
  2. Having decided on a position for the content page in the content tree strucuture ensure that the 'Parent Page' is properly set to the identified position (page).
  3. If any part of a content is likely to be reused under different contexts and hence in different pages, then abstract such reusable content into a separate page and include it in the various contexts (using the include macro) instead of duplicating the content across contexts.
  4. Since all pages should have a relevant Navigation Menu when composing a page divide the page into two columns (under a section) with the Menus going into the first column and the page content going into the second column.  Use the following as a template for all pages.
    No Format
    
{section:border=false}
{column:width=15%}
{include: <enter the name an existing Menu page from the 'Menus' category of pages>}
{column}
{column:width=85%}
<<enter page content here>>
{column}
{section}
  5. If there are going to be a set of pages that are likely to be created with the same specific set of menus then a easy way of creating them as per the above template is to go and first create a template page at http://cwiki.apache.org/confluence/pages/templates/listpagetemplates.action?key=TUSCANYImage Removed using the above snippet with approprieate Menu pages substituted.  Subsequently when create a page go to http://cwiki.apache.org/confluence/pages/templates/listpagetemplates.action?key=TUSCANYImage Removedand exercise the "Create page from template" option against the template just created.  This will result in a new page with the appropriate sections and menus and the content can be right away filled in.
  6. If a new set of Menu options are to be created, then create a menu page for this under the 'Menus' category.  You can also choose to create a set of menu options reusing the existing Menu pages and 'including' them as required.

...