DocumentationExperience League Authoring Guide

What’s new in this authoring guide

Last update: August 18, 2026

banner

This page provides information about the latest additions to this guide. Minor updates not included.

August 2026

August 18, 2026

  • Authoring extensions: New article consolidating the extensions: What each one does, whee to find it, and how to install it.
  • Adobe ExL Authors extension updated to v1.0.6.

August 12, 2026

  • Events: Metadata table revised—last-substantial-update and doc-type are now required (validation coming soon); product downgraded from required to strongly recommended; speaker upgraded to recommended. Removed the note that images don’t render in event bodies.

August 10, 2026

  • Events: Metadata table expanded with a Required? column, plus new rows for duration, jira, speaker, index, and a Legacy tags group (mostly unused holdovers). New YAML format section showing structured YAML (lists) instead of comma-delimited values for multi-value fields like role, product, and speakers.

  • GHEC Migration: Migration is now complete for all repos (events.en, the last holdout, has migrated). Simplified the incomplete-features list and noted that most intermittent publishing issues are resolved, with only edge cases remaining.

  • Editorial guidance and Screenshots: New Third-party interfaces cross-reference guidance—when steps involve a third-party UI, link to the third party’s own documentation instead of describing their interface; still add DNL to third-party names.

  • Editorial guidance: New Authoring extensions section (near the top of the page) consolidating the AdobeDocs Chrome extension, Adobe Markdown Authoring, and Adobe ExL Authors VS Code extensions—what each one is for and when to use it. Refined step-writing guidance to call for brief, complete sentences.

  • Editorial guidance: Rewrote First paragraphs guidance—the opening must answer “Why am I here?” New Structure: concepts and tasks ordering: H1, introduction, prerequisites, important limitations, procedure, examples, reference.

July 2026

July 30, 2026

  • Events: Clarified the process for creating past-event articles—confirm the video is uploaded to MPC, then create the article in the on-demand-events.en repo (often by copying a similar event). Metadata field renamed from series to series/event-series.

July 29, 2026

July 28, 2026

  • Events: New article covering the Events page, cloning the on-demand-events.en repo, folder/filename rules, frontmatter fields, and body syntax. Added to the TOC.
  • RedPen Scoring and Add and review Experience League tags: Removed Cursor-specific instructions; RedPen guidance now also calls out Claude as a supported VS Code-based editor. Noted that a RedPen action now runs automatically on new/updated files in PRs for repos that publish to production, and scores feed into CQI.
  • Configuring new repos: Added admin steps for Configure for Red Pen (installing the RedPen Reviewer GitHub app per repo) and for Create and configure public mirror.

July 27, 2026

  • Editorial guidance: Clarified the Experience Cloud → CX Enterprise rebrand—change the term in text only; do not change it in programmatic elements or metadata (except title and description metadata).

July 24, 2026

  • Editorial guidance: New Use a user-centered voice section—write from the reader’s perspective (Use X to do Y) instead of product-centered phrasing (X does Y), except in concept definitions. Quick-reference table rows now link to their sections.

July 23, 2026

July 22, 2026

July 17, 2026

  • Home: Expanded the searchable list of articles—added rows for every article in the main guide TOC that was previously missing from the table, plus direct anchor links into reference-heavy pages (the full metadata tag reference, Markdown syntax elements, validation error types, and more) so Ctrl+F/Cmd+F on this page finds more of the guide.

July 14, 2026

  • GHEC Migration: Migration status updated—only events.en remains unmigrated to GHEC (previously three repos, including the KCS repos and landing-pages.en). Removed resolved in-progress items (review environment, GitHub public mirror, VSC plugin validation caveat).
  • Microsites: Fixed broken example links. New Microsite migration section documenting V1 (git.corp, custom HTML renderer) versus V2 (GitHub, AEM-rendered) microsite sourcing while migration is in progress.

July 13, 2026

  • Hide a file: Renamed from Hiding files. Merged the two “Hide from TOC” sections into one, clarified that {hide-from-toc} goes on the article link or section in TOC.md (not in the article itself), and noted that the old V1 hidefromtoc: true article metadata no longer works.

July 9, 2026

  • RedPen Scoring: Extension updated to v1.2.1 (redpen-extension-1.2.1.vsix). Download link now points to the RedPen Home wiki. If upgrading from an earlier version, uninstall the previous extension before installing from VSIX.
  • Editorial guidance: New Use clear references section—pronouns and demonstratives (it, this, that, etc.) should have a single obvious antecedent; repeat the noun when ambiguity could confuse readers or AI systems.
  • Stage review content: Clarified that the review branch does not validate content. To validate, open a PR from review to main, fix any errors, then close without merging. Added color: red as an alternative dummy metadata trigger for the first commit. Slack notifications list updated files when content publishes to experienceleague-review.adobe.com.

July 8, 2026

July 6, 2026

June 2026

June 24, 2026

  • The landing pages repo has been migrated to GHEC. It takes only a couple minutes to update pages. It’s much easier and faster in V2, but the same template constraints are in place.
  • The Adobe Markdown Authoring plugin has been updated. It works now with the newest versions of Visual Studio Code.
  • Landing pages and breadcrumbs: Rewritten for the V2 GHEC repo—:::guides-list and :::tutorial-list section syntax, new link format, and manual descriptions (descriptions are no longer extracted from repos).
  • Hiding files: At least one article in the TOC must remain visible. If all articles are hidden, the TOC job fails.
  • Authoring best practices: Added VSCode Tagging Plugin to recommended VSC extensions. Admin steps for updating the Adobe Markdown Authoring extension in the VSC marketplace.

June 12, 2026

  • Adobe CX Enterprise application names: Expanded and updated the product table to align with Adobe Business products. Added products such as CX Enterprise Coworker, Acrobat Studio, Brand Intelligence, Content Analytics, Customer Journey Analytics B2B Edition, Engagement Intelligence, Express, Firefly Creative Production, Frame.io, GenStudio for Content Marketing, Product Analytics, and Semrush. Filled in approved second mentions for entries that were blank. Sorted the table alphabetically. Note: Adobe Express keeps Adobe in the approved second mention.

New guidance

  • Adobe CX Enterprise Coworker (first mention)
  • Coworker is an approved second mention
  • Use DNL on Coworker to preserve English and clarity

June 10, 2026

(June 5 update) See the Status board in #sccm-assistance.

June 4, 2026

  • RedPen Scoring: Extension updated to v1.2.0 (redpen-extension-1.2.0.vsix). If upgrading from an earlier version, uninstall the previous extension before installing from VSIX. (See the release notes wiki for features and fixes.)
  • Review is ready for testing: You can now create a review branch to publish content to experienceleague-review.adobe.com. This feature is still being tested.

June 3, 2026

June 1, 2026

Experience Cloud to CX Enterprise rebrand:

  • Editorial guidance: Use Adobe CX Enterprise on first mention, then CX Enterprise thereafter. Do not translate CX Enterprise.
  • GHEC Migration: Restructured for post-migration status—Major changes all writers should know (intermittent publishing issues, especially after metadata.md or TOC.md edits; nudge edits as a workaround), Minor issues (image align="left" rendering, Kodiak re-trigger, downloadable file allowlist, Last update accuracy), and new validation rules AM062 (SVG size limit) and AM063 (inline triple backticks).

May 2026

May 29, 2026

  • Publish content: Rewritten for the V2 pipeline. Merging to main publishes to production, stage, and dev by default. Use hold: true to preview without publishing to production (remove it when ready; do not use hold: false). Removed Jenkins Publish Now, activate-new, auto-activate schedule, and Edge troubleshooting sections. For draft articles, pair hold: true with {hide-from-toc} in TOC.md.
  • Work with GitHub pull requests and issues: Updated for GHEC - Make changes on github.com/Adobe-Enterprise-Docs, not the public github.com/AdobeDocs mirror. Do not merge public mirror PRs.
  • Hiding files: Documents V2 syntax only - hide: true or index: false for search; {hide-from-toc} in TOC.md for the left nav. Deprecated V1 hidefromtoc guidance is commented out.
  • GHEC Migration: Preview before publish with hold: true is now documented as available (no longer “nearly complete”).
  • Landing pages: Notes that the V1 landing-pages.en repo on git.corp is still in use until the V2 landing pages repo is ready.
  • Resolve validation errors: Notes that Kodiak security checks are required and controlled by Adobe IT; legacy Jenkins-specific validation details commented out.
  • Stage review content: Review-branch workflow updated; admin configuration link added.

May 27, 2026

  • VS Code Extension updated to 1.0.4: Includes updates and features requested for bulk tagging, copy and paste, type-to-find improvements, and keyboard shortcuts.

  • GitHub Enterprise Cloud (GHEC) Migration: Migration is complete for nearly all repos (three exceptions listed in the article). Removed preliminary, evaluation, and final phase instructions, dual git.corp/GHEC authoring notes, and the migration schedule callout. Open pipeline limitations and gotchas remain.

  • Auto-tagging page updates:

    • Let writers know to not manually edit metadata or remove V1 values;
    • Added section: Add metadata to a single file section for product, role, and feature tags on metadata.md, TOC.md, or individual articles; * Updated extension number to V1.0.3

Earlier in May 2026

GHEC and metadata

  • Using Metadata clarifies V2 behavior writers need now:

    • Use hide: true and index: true / index: false (not yes / no).
    • Hide articles from the left nav with {hide-from-toc} in TOC.md, not hidefromtoc in article metadata.
    • Optional last-update: YYYY-MM-DD overrides the auto-generated Last update date (for example, release notes).
    • Link to Add and review Experience League tags from the V2 tagging section.

Auto-tagging (V2 taxonomy)

Product naming

Hiding content

April 2026

December 2025

October 2025

September 2025

August 2025

  • Clarifying updates to metadata, removed old, misleading screenshots.

July 2025

  • New section on image limitations that cautions against using overly large images (i.e., more than 5 MB) or too many images in an article (100 or more).

June 2025

April 2025

  • New instructions for Acrolinx for Universal Editor & Perspectives.
  • New section for getting started with search engine optimization (SEO). Includes a no-frills guide (quick fixes to improve SEO), SEO fundamentals including measurement and tools, and AI prompts to help with SEO tasks.

March 2025

January 2025

December 2024

  • Updates to editorial guidance for all writers. (Bringing topics onto one page, simplifying guidance, authoring information design topics.)

November 2024

  • More explicit guidance to avoid certain filenames (such as search.md and metadata.md) and heading anchors (such as #search, #page, and #anchor) that can result in JavaScript/CSS conflicts. See Tips and rules to prevent common errors.

October 2024

September 2024

  • Heading and caps updates.

July 2024

May 2024

  • Reminder that self-service redirects using the repo’s redirects.csv is temporarily disabled. For now, contact Bob about adding redirects.

April 2024

March 2024

  • Updated capitalization standards (title case for title metadata; sentence case for all other headings and navigation elements).

February 2024

January 2024

  • Updated the Using Metadata: recommendations section to clarify how to disable the “More help on this feature” widget that appears at the bottom of the page.
  • When you assign type: Troubleshooting to an article, the normal documentation template is now applied to the page instead of the KCS template that does not have a left nav.

November 2023

October 2023

September 2023

August 2023

June 2023

  • Updated screenshots guidelines with information about inline images
  • Updated thumbnail size guidance (420 x 236) for videos
  • Updated headings guidance for clarity

May 2023

April 2023

  • Changed default rendering style for tables. The auto format is now the default style for all markdown tables and most HTML tables. Only HTML tables that do not have a header row are rendered using the fixed format. See Tables.
  • Other enhancements released April 28, 2023. See Release notes.

March 2023

  • Created videos for quick start guides (recording, editing, and uploading videos).

  • Updated solution and feature metadata for rebranded or EOL products. The following deprecated values are no longer available:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2
    Deprecated value Replacement
    Acrobat DC Acrobat
    Adobe Sign Acrobat Sign
    Experience Manager XML Documentation Experience Manager Guides
    Marketo Sky EOL or part of Marketo Engage
    Offer Decisioning AJO (Journey Optimizer) feature called Decision Management
    Debugger Experience Platform feature, not a solution
    Magento Commerce
    Magento Commerce Cloud Commerce
    Magento Open Source Commerce
    Search & Promote EOL
    Social EOL
    Advertising Cloud Advertising
    Tags Experience Platform / Data Collection feature
    Web SDK Experience Platform / Data Collection feature
    Core Services Experience Cloud Services
    Experience Platform Launch Experience Platform / Data Collection
    Intelligent Services Experience Platform / RTCDP feature
    Device Co-op EOL
    Dynamic Tag Management (DTM) Experience Platform / Data Collection feature
    Auditor EOL
    Livefyre EOL
    Mobile Services EOL

    For rebranding, see Product Rename Process.

February 2023

January 2023

November 2022

September 2022

  • Adding line numbering and highlighting to code blocks.
  • Added instructions for setting up a webhook to auto-create JIRA tickets whenever users log issues or submit PRs using the public mirror. Contact us if you want to enable this workflow.
  • Added instructions for writers to create jira tickets for logging bugs or enhancement requests for the EXL team.
  • Updated style guidelines with quick links and best practices on information design.

August 2022

July 2022

May 2022

April 2022

March 2022

  • Redirects processing now runs every two hours (every even hour, Pacific Time) instead of once a day.
  • Added content type examples (from AEP) in Content types.

February 2022

January 2022

  • Updated the Video page (MPC video process, general edits). KT/MPC experts, please send feedback to Blake.

December 2021

November 2021

  • You can now easily rename the Git default branch (archived: rename-git-branch.md) from master to main.
  • Run a quick job to remove all unused assets from your repo.
  • Added Gender and inclusive terminology as dedicated page to the topic.
  • Updates to Heading names and page titles. Added examples of all types of headings for tutorials and product docs, defined types of headings (overview, introduction, fundamentals of…, get started with…)

October 2021

September 2021

  • Updated guidance in Cleanup Tasks article. Please take a look at that article.
  • Updated documentation to explain that !UICONTROL and !DNL syntax can be added to HTML tables and code blocks. The pipeline strips out these UICONTROL/DNL tags during packaging for publication.
  • Can’t find what you’re looking for in this guide? We still can’t search within this guide, but the home page now has a list of articles and description/keywords. Press Cmd+F on that page to search for the term you’re looking for. Still not ideal, but maybe this helps. Feel free to edit that page with more keywords.
  • Documentation about creating contextual help popovers in product pages.

August 2021

July 2021

June 2021

May 2021

April 2021

  • New review branch is currently being tested for repos that are using the new version of Jenkins.
  • Art of the TOC - Rewrote guidance on tables of contents.
  • Metadata - Full rewrite to metadata, tagging, yaml locations, and more.

March 2021

February 2021

January 2021

  • Updated metadata guidance for title and description to improve SEO. We’re also rolling out new feature, topic, role, and level metadata (in-progress). See Metadata.
  • Added info about manually installing the Adobe VSC extension.
  • Added additional values for product metadata.

December 2020

November 2020

  • The activate-exl job now pushes content live immediately. The 2-hour pickup schedule applies only to auto-activated repos. See Publish content.

October 2020

recommendation-more-help
authoring-guide-help-main-guide