This is a living document that dives into the nitty-gritty details, the things you should consider to be best practices for when you begin to write content for your content area in the Portal. As an editor, it’s up to you to decide what you want to write about, but when it comes to how to present that information, there are a few things you should know.

We’ll be keeping this document updated as best practices and procedures for writing for the web change and evolve. Please remember to check back periodically to make sure you’re up-to-date with the guidelines as they’re presented in this document.

Table of Contents:

• The Portal: A Style Guide (v2)
  • Structure
    • What’s the point?
    • But what does that look like?
    • Why are these subheadings capitalized differently?
  • Accessibility
    • Headings and Structure
    • Link Text
    • Images and alt-text
    • Additional Accessibility Resources
  • Active Voice
  • Formal vs. Informal
  • Editing: It’s a Thing
  • Images
    • Copyright
  • Video
  • Search Engine Optimization (SEO), a.k.a How People Find My Content
  • Various Style Notes
  • Serial/Oxford Commas
    • Headlines/Capitalization
    • Miscellaneous

If you’re looking for a guide on how to use the Wagtail platform, then please refer to our Wagtail platform documentation, which focuses exclusively on the how-to’s of using the Wagtail content management system. For any comments, questions, help, or concerns please email us at: portalcontenthelp@cca.edu.