Style Guide

From Layton Support
Revision as of 04:58, 9 November 2012 by Jlangston (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Contents

Product Names

These are the agreed-upon written representations of the product names. When used in a page name, follow the name with a ™ symbol No more trademark symbols, thanks:

  • Layton ServiceDesk
  • AuditWizard
  • HelpBox
  • DeviceShield

Page-Naming Conventions

For the user-guide pages, begin with the product name, then a hyphen, then the section name, another hyphen, then the page name.

Pages should simply be named after the configuration menu or concepts they cover. This make for more convenient and thus more likely cross-linking within articles which should occur as often as possible.

Images

Images were previously unframed as well as positioned and captioned with HTML markup. Things like positioning, framing, captioning and more should be handled by paramter as much as possible.

Things That Need To Occur

  1. Wiki-wide Adjust of "Layton ServiceDesk" to "Layton ServiceDesk"
    1. Move pages to fit new page naming scheme that does not include the product name on every page.
      1. Establish Test Wiki
      2. Figure Out Ramifications of Page Movement If Any
      3. MOVE THEM
    2. Find and Replace all other instances within the text. Hopefully this can be handled via SQL Script
  2. Refactor all images as they are incurred to remove HTML markup and replace with proper wiki markup
  3. Get Rid of all of those "Back to Table of Contents" links on every page
    1. Look into how to otherwise establish breadcrumbing

References

Personal tools
Namespaces

Variants
Actions
Main Page
Online User Guides
General Support
Release Notes
Toolbox