Website editing guidelines

Owned by Wendy Thomas
Last updated: Jan 16, 2025
3 min read

NOTE: These guidelines are in place during the development and review period for the website. Design and editing guidance changes will be guiding by a web management group which has yet to be established.

Home page
https://ddialliance.org

Editing page
https://app-eu1.hubspot.com/login/

HubSpot guides:

Getting started with HubSpot CMS tools
https://app-eu1.hubspot.com/academy/144531336/lessons/1054824/5082
Suggest:
How to Create a Page in Content Hub

Beginning

  • Log in

  • Select “content” on left-hand tools column then “Webpage”

    starting.png

 

General editing guidelines

  • Avoid direct cut and paste except from a basic text file, this prevents inadvertently changing fonts or text size

  • Use site tools to provide formatting (lists, links, inserting images, etc.)

  • We are currently using the ONE_COLUMN_STARTER_PAGE as the standard template.

  • Pages are split into the following groupings:

    • Product pages (product section plus resources, markup examples, tools, relationships to other standards, and getting started) – Wendy is editor

    • Administration and remaining pages under Learn – Jared is editor

    • Data base generated pages – managed by Daren and Oliver, updating content is handled by relevant editor

Modifying an existing page

  • NOTE: we do not support a "last updated" notification on the page as this has been inconsistently used (editors can get this information from the page listing which is more reliable)

  • Locate page you wish to edit (start typing name in search space)

  • Modifying content Title, subtitle, content (add details)

  • Modifying structure

    • (add details regarding lists, images, type of text, etc.)

    • (add guidelines regarding multi-column, or other differences)

    • Do not alter basics such as font type or overall size (size change be changed for differentiation from other text)

Creating a new page


Locate: ONE_COLUMN_STARTER_PAGE

 

one_column-select.png

 

  • Hover over ONE_COLUMN_STARTER_PAGE

     

  • Click on “Clone”

  • Add new name for page and click on clone (this is the name that appears on the list and may be a shorted version of the page title)

  • When new page template opens click on Settings to complete name changes

     

    • The name you entered will show in Internal page name

    • Provide an NCNAME for the page (this must be unique)

    • Click on edit symbol on the page URL to update the slug on URL to short meaningful NCNAME (note that we do not capture nesting here allowing for easy movement of content pages by redefining the nesting and listing under primary content columns)

Links

  • Internal

    • These should be relative links using the link process and stub information

    • This pertains to both internal web pages and documents

  • External

    • (use DOI for external documents when available, otherwise full URL)

Nesting of pages

(how to)

Attaching content to drop-down lists

Primary and secondary listings - add guidance on what should be listed in secondary items

Updating related content

(addition or movement of some pages may require updating a summary page for a drop-down header)

Updating database content

(add information on how to add new content or update existing content to various databases. This may include the use of entry forms)