Versions Compared

Key

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

Guidelines / Best Practices

  • Please follow the DeveloperWiki and ReadTheDocs Usage Policy
  • 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.
  • Consider using page tree hierarchy and/ or label query macros to organized multiples pages are expected to be added under a higher level page rather than maintaining a list of references in the higher level page content.
  • 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 landing page - if you place any new page at level 3 or below - it will keep the landing page concise.
  • Recording your screen: OSX will record your screen if you have the QuickTime Player installed - see the ONAP 1.0 Demo videos as an example.

...