Release Note Format Definition
The file can have any name as long as it resides in src/release-notes. Only the content of the file controls the website content.
The file can live in folders to better organize large numbers of past release notes.
The file can use any MDX allowed in documentation, but it's strongly advised to only use basic markdown and no headings before the "read more" separator.
Metadata are defined as YAML frontmatter.
The URL of this release notes details page inside a microsite would be /releases/2000-03-03-release-note-format-definition.
The URL of this release for example in the merchant-center microsite would be https://docs.commercetools.com/merchant-center/releases/2000-03-03-release-note-format-definition
The <!--more--> syntax for separating out the long form from the part shown in the list is to be taken over from the Jekyll convention. Unprepared new users have understood it intuitively because it's explicit and the company knows it already.
Frontmatters:
date(date, required): AYYYY-MM-DDdate format (not a text, it's parsed as an ISO date).title(string, required): The title for the website.description(string, required): Max 256 characters plain text containing the change and its advantage ("tweet-able" and for RSS). 256 = 280 twitter minus 23 for a link. Do not imply the title, this text is used stand-alone in Merchant Center and other feed recipients. It must convey the value proposition and key change topic.type(string | string[], required): Must be eitherfeature(for "New feature"),enhancement(for "Enhancement"),fix(for "Resolved issue"),announcement(for "Announcement") ordeprecation(for "Deprecation").orderHint(number, optional): Sorts release notes that share the same release date. Uses an ascending order with 1 being the most recent release note and 20 being the oldest. This logic works across multiple microsites. If you have multiple release notes from different microsites with the same release date, add this frontmatter to the respective release notes to sort them accordingly from 1 to 20.topics(array of string, optional): YAML array of free to choose text entries. The Filter UI may be constrained to pre-defined topics.published(boolean, optional, defaults totrue):falseprevents rendering of the release in the site. Should not be used in the main documentation, reserved for atypical situations. Not included in the template.slug(string, optional, defaults to$date-$title(slugified)): Allows overriding the autogenerated URL slug. Should not be used in the main documentation, reserved for migrating legacy docs.product(string, optional): Used in the release notes search to filter by product. If set, it overrides theproductdefined in the websitegatsby-configure.mjs. Please note that in case an array is defined, just the first value is used for filtering purposes.productArea(string, optional): Used in the release notes search to filter by product area. If set, it overrides thetitledefined in the websitegatsby-configure.mjs.hideProductLabels(boolean, optional): Used to hide the product and productArea labels on the release note details and list page.