Merge pull request #96 from froboy/main

Early 2025 wrap-up

content/en/docs/howto/content-audit/_index.md

@@ -20,4 +20,13 @@ Visit each page and review content.
 - Identify key pages & content types
 - Locate content that is outdated, duplicated, needs further review, consolidation etc.
 - Find content gaps - what might be missing?
-- Identify commonly used page components (i.e. Cards, Carousels, Accordions, Ping Pongs, etc.)
+- Identify commonly used page components (i.e. Cards, Carousels, Accordions, Ping Pongs, etc.)
+
+## Additional Resources
+
+For more information on content audits, check out these resources:
+
+- [Content Audit: A Step-By-Step Guide (MightyBytes)](https://www.mightybytes.com/blog/how-to-run-a-content-audit/)
+- [Content Inventory and Auditing 101 (Nielsen Norman Group)](https://www.nngroup.com/articles/content-audits/)
+- [Time to Revamp Your Nonprofit Website’s Content Strategy? 5 Tips to Get Started (ImageX)](https://imagexmedia.com/blog/5-tips-non-profit-content-strategy)
+- [Best Website Audit Tools (Five Jars)](https://fivejars.com/blog/best-website-audit-tools)

content/en/docs/howto/use-structured-data/_index.md

@@ -50,3 +50,19 @@ Tips for writing good FAQ content:
 ### Customizing FAQs
 
 Due to the complexity of the FAQ data, the structured data is [managed entirely in code](https://git.drupalcode.org/project/lb_accordion/-/blob/1.0.x/lb_accordion.module?ref_type=heads#L40) and is not customizable via the Drupal admin. If you need specific customizations, please post your ideas in Slack or suggest them on [the Roadmap](/roadmap) for the core team to discuss and implement.
+
+## Other Metatags
+
+The distribution also includes metadata configuration for each content type, which can be found in the Metatag configuration (`/admin/config/search/metatag`).
+
+### Homepage Metatag Overrides
+
+On some sites, the homepage may have unique metadata requirements. The homepage metatags can be overridden in the "Front page" metatag configuration.
+
+For sites that use Layout Builder, it may be necessary to disable the **Front Page** metatag settings so that the **Landing Page (Layout Builder)** tags can be used instead.
+
+1. Go to `/admin/config/search/metatag/front`
+2. Scroll to the bottom of the form.
+3. Uncheck **Active** and Save the settings.
+
+Once you have changed the settings, check the metadata of the homepage with a tool like [Social Share Preview](https://socialsharepreview.com/) to ensure the correct data is being output.

content/en/docs/user-documentation/content-types/_index.md

@@ -5,10 +5,24 @@ description: >
   YMCA Website Services features many different kinds of pages, or content types. Choosing the right content type will ensure your collect the right information and allow you the flexibility to create layouts.
 ---
 
+A **content type** is a reusable container for content. Content types have a common structure and purpose. They support site architecture and make content presentation consistent. This helps people find what they need.
+
 There are two different kinds of Content Types in the distribution:
 
-- **"Standalone types"** are content that is displayed directly to users, like Landing Pages and Branches. They may also be displayed in views or other groupings.
-- **"Helper types"** are content that is never displayed on its own to users. It is displayed in aggregate or as part of a supporting application like Activity Finder or Membership Calculator.
+- **Standalone types** are content that is displayed directly to users, like Landing Pages and Branches. They may also be displayed in views or other groupings.
+- **Helper types** are content that is never displayed on its own to users. It is displayed in aggregate or as part of a supporting application like Activity Finder or Membership Calculator.
+
+Most sites will be built using a combination of these content types. The right content type for your content will depend on how it will be used and displayed. Landing Pages will often make up the bulk of your site, but you may also need to create Events, Articles, Branches, and other content types to support your site's goals.
+
+## Which Content Type Should I Use?
+
+Before you begin building your site, you should have a good idea of what kind of content you will be creating. Consider conducting a [content audit](../../howto/content-audit) to understand what content you have and what content you need to create.
+
+Once you begin building your site, you will most likely start building Landing Pages. These are the most flexible content type and can be used for a wide variety of content.
+
+Location pages like Branches and Camps are also important to build out, as they will be used to promote each individual location.
+
+Finally, you can create supporting content types like Events and Articles to provide more timely information to your users.
 
 ## Standalone Content Types
 
@@ -20,14 +34,16 @@ These content types are built for Layout Builder or are Layout Builder-compatibl
 - [Camp](./camp)
 - [Facility](./facility)
 - [Landing Page (Layout Builder)](./lb-landing-page)
+- [Program](./program)
+- [Program Subcategory](./program-subcategory)
+- [Promotion](./promotion)
 
 These content types use the legacy Paragraphs page builder:
 
 - [Blog Post](./blog-post)
 - [Landing Page](./landing-page)
 - [News Post](./news-post)
-- [Program](./program)
-- [Program Subcategory](./program-subcategory)
+
 
 ## Helper Content Types
 

content/en/docs/user-documentation/content-types/promotion/_index.md

@@ -5,6 +5,8 @@ description: Flexible content that can be inserted into components as advertisem
 
 Promotions are timed pieces of content that allow content editors the flexibility to create a single item that can be placed in multiple locations on the site, without having to duplicate or manage content in multiple locations.
 
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/hrFHguHoDNE?si=WN-h6H3QuYRQYMgA&amp;start=218" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
 Version 1 of the Promotion functionality was released in [version 10.3.1.1]({{< relref "release-ds-10.3.1.1.md" >}}) (December 2023). This version supports swapping promos into:
 
 - Activity Finder
@@ -14,8 +16,6 @@ Version 1 of the Promotion functionality was released in [version 10.3.1.1]({{<
 - Modals
   - by enabling the `ws_promotion_modal` module.
 
-Version 2 is planned for March 2024 and will support more components with more granular placement criteria.
-
 ## Creating a Promo
 
 Go to **Admin** > **Content** > **Add Content** > **Promotion** (`/node/add/promo`)