What’s new in this authoring guide

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

June 2021

• (In dev) 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.
• 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

The README.md file in the main directory of each repo includes a set of key links. Click these links to check validation, run activation, or view preview or published content.

• Validating EXL content
• Preview and publish
• Redirects
• Hiding articles
• Acrolinx
• VSC plugins
• Stage workflow not yet hooked up.