• Shared Things
• Layouts, Code Snippets (Company level)
• Section Numbers
• Assets
• Themes in Site Admin
• Documentation

The instances follow the same structural layout, so be aware that the following company level items may be shared:

• Layouts (Themes, Pages, Sections, Modules/Forms)
• Code Snippets
• Section Numbers
• Section Guide Documentation
• Dev Guide Documentation

Note: Instances may also have unique company level things, not everything will be shared.

• Version Naming:
  • Layouts and Code Snippets will include a prefix with the site version/instance. This indicates which instance the component can be assigned to.
  • If the prefix is “v2 – “ the component can be assigned to any instance.
  • If the prefix includes an instance name (example “v2 - Section 10 - Navigation - AHNC"), use the component only in that instance. If later on, the layout needs to be used on more than one instance, rename the layout using "v2 - " as the prefix.
  • Any new company level components that are created should follow these guidelines.
  • Version prefixes apply to Theme Layouts, Page Layouts, Section Layouts, Module/Form Layouts, and Code Snippets.
• Code Snippets:
  • Make sure any Code Snippet that can be used on your instance is showing in custom html modules in your instance.
  • You will need to assign Code Snippets to your instance using the "Site List" dropdown found in the Code Snippet page. Note any existing shared "v2" snippets will need to be updated to include your instance.
• Section Layouts: You must follow these guidelines:
  • Create a Section Layout for each Section Number. If the section has variants, you may use the same layout for all of the sections.
  • The Section Guide documentation should be included in the Section Layout code. This way, the same section documentation will be visible on all instances and only need to be updated in one place.

  • Syntax for Section Layout names:

    "Version Prefix - Section # - Short Descriptive Title"

    (example: "v2 - Section 14b - Mulitple Items")

• Section Numbers will be assigned at the company level and available to be shared across all v2 sites.
• To find the next unused Section Number, look at the Section Layout Page in the admin, filter by "v2" and sort alphabetically. Assuming the naming syntax above has been followed, you should be able to see all of the section numbers that are currently in use.
• Some instances may have unique section designs (section numbers) that are only for that site. Once a number has been used for a section design, it should not be used again. This is why it is important to know all of the Section Numbers that have been assigned for v1 sites at the company level.
• Follow the Section Layout guidelines above.

• For consistency, follow the same asset folder structure for all instances.
• The site root folder name should clearly communicate what instance it is for.

Themes that should be included in every instance:

1. "Default Theme"
   • CMS Enabled
   • SASS and JS that is unique to your instance only. The SASS and JS files will be named and assigned automatically when you create the site.
2. "Primary CMS Theme"
   • CMS Enabled
   • Assign the same SASS and JS files that are assigned to the Default Theme.

Documentation should stay current. Please make sure you look at the Layout Sections to make sure you do not duplicate a layout.

• CMS Guide Page

• Dev Guide Page