What’s new in this authoring guide

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

September 2021

• 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-levels metadata 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. Auto used git-flavored markdown rendering. Fixed uses 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 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

• 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-exl job now pushes content live immediately. The 2-hour pickup schedule applies only to auto-activated repos. See Publish content.

October 2020

• Validating EXL content
• Preview and publish
• Redirects
• Hiding articles
• Acrolinx
• VSC plugins