Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add to best practices

<<TODO: describe the process for contributing to this wiki>>

...

Guidelines / Best Practices

WIP: ongoing list.....

Pick good page title names representative of page content, unique across wiki space, and that won’t change in title but could be moved around in the page tree hierarchy. 

Avoid changing page titles, but if you expect changes will be needed, use the tiny URL link when referencing in email, external to wiki space site references, etc.

Avoid splitting up page content once it has been published and comments/references exist.  Context assumptions are subtle and easily broken.

Use page tree hierarchy and/ or label query macros to organized multiples pages under a higher level page rather than maintaining [wiki references] or URLs.

Embedded images sometimes will pixelate - reedit the size by a couple pixels on a 2nd save and they should be fixed.

Notice that any 2nd level pages will appear in the logging landing page - if you place any new page at level 3 or below - it will keep the landing page concise.

...