What’s new in this authoring guide
This page provides information about the latest additions to this guide. Minor updates not included.
September 2025
- New Changed URLs report for Jenkins Reporting. The Changed URLs is especially useful for AI teams looking for new and changed URLs.
- Article about creating slides
- Article about creating playlists
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
- New section on Git corp to GitHub Enterprise migration.
- Useful Slack channels, including
exl-singularity-test: Slack channels. - Updated guidance for steps and bullet lists to reflect CSS changes for lists: Steps and lists.
- Authoring guide is migrated to GitHub Enterprise in a new repo and published live: https://experienceleague.adobe.com/en/docs/authoring-guide/using/home
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
- New instructions for redirects.
- New (and early) instructions for signing in to new GitHub Enterprise.
- Instructions for changing how Previous/Next buttons work.
- Added Snagit guidance and ExL theme for screenshots.
January 2025
- Revamped screenshot guidance.
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.mdandmetadata.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
- Updates to Simplified editorial guidance for writers
September 2024
- Heading and caps updates.
July 2024
- Added link to wiki page for using Spectrum icons.
- Updated instructions for creating github-jira tickets.
- Created simplified editorial guidelines for UE authors and user-generated content (in progress)
May 2024
- Reminder that self-service redirects using the repo’s
redirects.csvis temporarily disabled. For now, contact Bob about adding redirects.
April 2024
- Updated documentation for ongoing publishing issues and temporary redirect workflow.
- Key post-migration bug fixes for scrambled table syntax and inline badges. See Release notes.
March 2024
- Updated capitalization standards (title case for title metadata; sentence case for all other headings and navigation elements).
February 2024
- Added section about installing and using the AdobeDocs Chrome extension.
- Added suggestions for using Generative Summary AI in Acrobat to summarize content. (Not officially supported by ExL.)
- Updated Authoring effective headings with information about What’s new headings and more.
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: Troubleshootingto 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
- Updates to metadata guidance for Topics and Created for.
- Updates to editorial guidance for a table of contents.
October 2023
- Added FAQ for metadata.
September 2023
- Center and right-align columns in tables.
- Added Branding guidelines for Experience Cloud to the TOC (under Style guidelines and SEO section). This link opens a PDF.
August 2023
- Support for video transcripts.
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
- Added FAQ guidelines
- Updated Steps and lists
- Updated Table of contents authoring
April 2023
- Changed default rendering style for tables. The
autoformat 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 thefixedformat. 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
solutionandfeaturemetadata 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
- Updates to get started authoring topics (ongoing)
- Release of multiple new features Feb 4-6. Info
January 2023
- New section on obtaining a list of URLs for your repo. This is especially useful for when you make lots of changes the TOC.md file and need redirect URLs.
- [Feb. 6 release]{class="badge informative"} Badges
- [Feb. 6 release]{class="badge informative"} Click-to-zoom images
- Added guidance for screenshots and diagrams
- Updated capitalization guidance
November 2022
- New feature: Shade boxes
- New feature: Tabs
- New feature: Image resizing and aligning
- Created videos for Working with public mirrors and Copying pull requests from public mirror to corp.
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
- Maximum file size for images and download files is 100 MB (the github.com limit). Documented in syntax style guide.
- Support for yellow highlighting. Used by the Workfront team to preview upcoming features.
- Updated Title and Description metadata guidance.
- Updated style guidelines with best practice tips on information design.
- Updated What you should know about metadata to help clarify important points about metadata.
July 2022
- Added an example for the description (metadata) you can use on a home page. (See Descriptions.)
- Streamlined the definitions of guide and tutorial. (See Content types in Experience League documentation.)
May 2022
April 2022
- Added guidance for Alt-text authoring in Markdown.
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
- Line numbering in code blocks - Use this format to add line numbering in fenced code blocks: ````html {.line-numbers}`
- Includes and snippets for sharing content within a repo
- Collapsible sections (accordions)
- Added guidance on names for integrations
- New getting started pages for different authors (documentation, tutorials, intermittent) in progress.
January 2022
- Updated the Video page (MPC video process, general edits). KT/MPC experts, please send feedback to Blake.
December 2021
- Fully revamped the Metadata page.
November 2021
- You can now easily rename the Git default branch (archived: rename-git-branch.md) from
mastertomain. - 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
- Added information about creating sub-steps in Steps and lists.
September 2021
- Updated guidance in Cleanup Tasks article. Please take a look at that article.
- Updated documentation to explain that
!UICONTROLand!DNLsyntax 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
- Instructions for viewing broken external links and excluding URLs from being checked.
- The Adobe Markdown Authoring extension is now available in the VSC Marketplace. See Adobe Markdown Authoring extension for VSC.
July 2021
- View this auto-updated report for a list of broken or problematic external links in your repo.
- Created Get started publishing to Experience League (formerly, New Publication Checklist). Covers onboarding tasks for new projects and authors.
June 2021
- Added Tips for improving your writing clarity
- Updates to Headings and page titles
- (Now live) Use
mini-toc-levelsmetadata to determine how many levels of headings are displayed in the right nav. The default number of levels is 2. You can specify 1-6 levels. Levels are now indented properly in the left nav. See Metadata. - Added guidance for writing procedures. See Steps and lists.
- You can create links that open in a new tab.
- Microsites are now available for uploading HTML files to EXL without using the markdown authoring pipeline.
- Updated Clean-up Tasks.
May 2021
- Updated Acrolinx regarding the Visual Studio extension.
- Updated Jenkins validation, staging reviews, and other articles to reflect new post-migration capabilities, including Slack notifications.
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
- New table formatting option - Lets you use special syntax (
{style="table-layout:auto"}) to change how a table is rendered.Autoused git-flavored markdown rendering.Fixeduses the current rendering method. - Content types - Definitions of deliverable types and overview, concepts, tasks, and so on.
- New Jenkins instance for testing
- Headings for concepts, tasks, and page titles - New guidance for authoring headings.
- New project checklist - Get started publishing to Experience League
- Acrolinx - Updates to the extension setup.
- Metadata - Updates to tagging, yaml locations, and more.
February 2021
- Hiding content updates.
- Acrolinx progress.
- Metadata updates.
January 2021
- Updated metadata guidance for
titleanddescriptionto improve SEO. We’re also rolling out newfeature,topic,role, andlevelmetadata (in-progress). See Metadata. - Added info about manually installing the Adobe VSC extension.
- Added additional values for
productmetadata.
December 2020
- Added information about search metadata in Improving search results.
- Updated metadata (ongoing changes related to landing pages, search filters, and SEO improvements). See Metadata.
- Updated Getting started.
November 2020
- The
activate-exljob now pushes content live immediately. The 2-hour pickup schedule applies only to auto-activated repos. See Publish content.
October 2020
recommendation-more-help
92f1a422-8a81-400b-85d3-388f0c36dfda