What's New

Deliverables / SAP Help Portal

Overview

These guidelines apply to the SAP BTP core, environments, and services. Please follow them when preparing release notes for the platform. Our goal is to achieve and maintain consistency and high-quality deliverables.

Note: If your service is not part of the SAP BTP Cockpit and Discovery Center, contact Alexandra Gogolin to check if the SaaS guidelines apply.

You can find instructions about how to provide content for the new design in Tasks for the Authors. These guidelines are for the values to provide in your component table in Ixiasoft and the examples show how the output looks on SAP Help Portal. The output can show the attributes in a list and a table view. However, the guidelines and examples below show the default list view.

We publish all platform-related release notes on UACP at What's New.

Please follow these major guidelines when you prepare release notes for the What's New viewer:

Always include the action for required and recommended actions with information about WHAT the action is and HOW to achieve it.
Wherever applicable, add links for more information. An exception could be, for example, trivial minor updates or self-explanatory changes that require no action on behalf of the customer.
Keep the release note short. If you need to describe lengthy procedures, use cases, concepts or background info, add links instead.

If the release note becomes too lengthy but there is no relevant topic (in another deliverable) to link to, create a dedicated topic in the central WNV map. Shorten the release note text and add a link to that topic for more information.

Responsibility

It is the responsibility of the UA developer of each team to apply these guidelines.

If you are a product owner of a team that does not have a UA developer, please familiarize yourself with and follow these guidelines. Once you have prepared and reviewed your release notes, you can send them to us for an additional check.

Pattern

Use the following pattern for all notes:

<div> <div><strong>Field</strong></div> <div>Description</div> </div> <div> <div><strong>Technical Component</strong></div> <div>Name of service or component</div> </div> <div> <div><strong>Environment</strong></div> <div>One of the available environments. See <a href="https%3A%2F%2Fwiki.one.int.sap%2Fwiki%2Fx%2F3ExrbQ">Tasks for the Authors</a>.</div> </div> <div> <div><strong>Title</strong></div> <div>Subcomponent, feature, or entity</div> </div> <div> <div><strong>Description</strong></div> <div> <p>Short description with a reference to the official documentation</p> <p>Action: <provide what the action is and how to achieve it if it is recommended or required. If the value is <em>Info only</em>, don't provide any action information. See <a href="https%3A%2F%2Fbtpx.frontify.com%2Fdocument%2F223128%23%2Fsap-help-portal%2Fwhat-s-new%2Faction-definition">Action Definition</a>.</p> </div> </div> <div> <div><strong>Action</strong></div> <div> <p>Use one of the following:</p> <ul> <li>Required</li> <li>Recommended</li> <li>Info only</li> </ul> <p>For more information, see <a href="https%3A%2F%2Fhelp.sap.com%2Fdocs%2Fbtp%2F922bf2dbe0b646aaaa8cb5e077cfd799%2Fffdd91a22c3247498fa6dc3e62165133.html%23action">Filter and Label Descriptions</a>.</p> </div> </div> <div> <div><strong>Lifecycle</strong></div> <div> <p>Use one of the following:</p> <ul> <li>Beta</li> <li>Restricted Availability</li> <li>General Availability</li> <li>Deprecated</li> <li>Deleted</li> </ul> <p>For more information, see <a href="https%3A%2F%2Fhelp.sap.com%2Fdocs%2Fbtp%2F922bf2dbe0b646aaaa8cb5e077cfd799%2Fffdd91a22c3247498fa6dc3e62165133.html%23lifecycle">Filter and Label Descriptions</a>.</p> </div> </div> <div> <div><strong>Type</strong></div> <div> <p>Use one of the following:</p> <ul> <li>New</li> <li>Changed</li> <li>Announcement</li> </ul> <p>For more information, see <a href="https%3A%2F%2Fhelp.sap.com%2Fdocs%2Fbtp%2F922bf2dbe0b646aaaa8cb5e077cfd799%2Fffdd91a22c3247498fa6dc3e62165133.html%23type">Filter and Label Descriptions</a>.</p> </div> </div> <div> <div><strong>Line of Business</strong></div> <div>This attribute is used for the consolidated What's New viewer and its default value is <em>Technology</em>. Leave the default value unless instructed otherwise.</div> </div> <div> <div><strong>Moduler Business Process</strong></div> <div>This attribute is used for the consolidated What's New viewer and is not applicable for the standalone SAP BTP viewer. Leave the default value <em>Not applicable</em> unless instructed otherwise.</div> </div> <div> <div><strong>Latest Revision</strong></div> <div>This is the date you want to notify your subscribed customers for the release note. See <a href="https%3A%2F%2Fwiki.one.int.sap%2Fwiki%2Fx%2F3ExrbQ">Tasks for the Authors</a>.</div> </div> <div> <div><strong>Available as of</strong></div> <div>Release date</div> </div>

warning

Component
Please use a component that best matches your use case. Don't use a general component that doesn't give specifics. You can ask your product owner what component best matches your use case. Furthermore, use only approved terms for components.

Example 1: I have a new functionality for metrics that is for SAP BTP. I shouldn't use the SAP BTP component, but the service it is relevant for, which is the Monitoring Service component.

Example 2: Don't list multiple features available per specific region under the Region component. Instead, use the respective service component.

However, you can add the tool in addition to your component (service) to facilitate findability. For example, your development team implements a new feature in SAP BTP Cockpit, and you can add it to your Component column. This is done in a tag as it's with the Environment column.

Example 3 - Entry in the Technical Component Column Cloud Management Tools SAP BTP Cockpit
<sl>

<sli>Cloud Management Tools</sli>

<sli>SAP BTP Cockpit</sli>

</sl>

Example 4 - Entry in the Technical Component Column SAP Monitoring Service/sli> SAP BTP Cockpit

<sl>

<sli>Cloud Management Tools</sli>

<sli>SAP BTP Cockpit</sli>

</sl>

These columns look like this in the list view:

<Technical Component> - <Title>

Customer Feedback

Announce an improvement that is the result of customer feedback.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p><Change description>. See <link to documentation>.</p> <p>[Customer feedback]</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>SAP BTP Cockpit</strong> - Performance of Services Page</p> <p>The performance of the Services page in the SAP BTP cockpit has improved. Now the services load in the cockpit about seven times faster than they did a month ago. <em>See Using Services in the Neo Environment</em>.</p> <p>[Customer feedback]</p> <p>Cloud Foundry • Info only • General Availability • Changed</p> </div> </div>

Experimental Features

Describe experimental features.

You first create a topic following the instructions in Experimental Features. You then refer to the topic in the release note description and add the [Experimental] tag at the end. Furthermore, you use the Lifecycle value Beta.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><Technical Component> - <Title></p> <p><Change description>. See <link to documentation>.</p> <p>[Experimental]</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p>Business Rules - Expression Language</p> <p>Business Rules supports expression language 2.0. See <em>Expression Language 2.0 (Experimental)</em>. [Experimental]</p> <p>Cloud Foundry • Info only • Beta • New</p> </div> </div>

Beta Features

Describe beta features.

You first create a topic following the instructions in Beta Features. Then refer to the topic in the release note description and add the [Beta] tag at the end. Furthermore, you use the Lifecycle value Beta.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><Technical Component> - <Title></p> <p><Change description>. See <link to documentation>.</p> <p>[Beta]</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p>Business Rules - Expression Language</p> <p>Business Rules supports expression language 3.0. See <em>Expression Language 3.0 (Beta).</em> [Beta]</p> <p>Cloud Foundry • Info only • Beta • New</p> </div> </div>

Action Definition

You have to add a value (Required, Recommended, or Info only) in the Action column that specifies the level of disruption and if an action is required by the customer. For more information, see Filter and Label Descriptions. When an action is required or recommended, please add the following paragraph at the end of the description:

Action: <include information about WHAT is required or recommended and HOW the customer has to achieve it. In case of complex actions and too much information in the release note, provide links to topics describing what the action is and how the customer has to achieve it.>

warning

If you repeat a release note after you have announced a required or recommended action, use the same action reminder in the repeated release notes because the action might not have been completed.

Examples:

Fix

Announce that a bug is fixed. Please use something more specific for the Title (try to avoid repeating the Technical Component in the Title).

warning

We recommend that you don't just state "Bugfixes and Improvements" without describing any details. This information does not bring value.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p>An issue was resolved... <change description>. See <link to documentation>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>Monitoring Service</strong> - Monitoring Parameters</p> <p>An issue was resolved that required the Monitoring service to be restarted for the changes to monitoring parameters to take effect. See <em>Monitoring Parameters</em>.</p> <p>Neo • Info only • General Availability • Changed</p> </div> </div>

Version Update

Announce that an old version is replaced with a new one.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p><component> has been updated from version <old version> to <new version>. See <link>.</p> <p>or</p> <p>More information:</p> <p><links></p> <p>If an action is required or recommended, add the following paragraph at the end of the description:</p> <p>Action: <include information about <strong>WHAT is required or recommended and HOW the customer has to achieve it</strong>. In case of complex actions and too much information in the release note, provide links to topics describing what the action is and how the customer has to achieve it.></p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>Diego</strong> - New Version</p> <p>Diego has been updated from version 1.28.0 to 1.30.0.</p> <p>See changelog from Diego:</p> <ul> <li><a href="https%3A%2F%2Fhelp.sap.com%2Fviewer%2Fdisclaimer-for-links%3Fq%3Dhttps%253A%252F%252Fgithub.com%252Fcloudfoundry%252Fdiego-release%252Freleases%252Ftag%252Fv1.29.0">v1.29.0</a></li> <li><a href="https%3A%2F%2Fhelp.sap.com%2Fviewer%2Fdisclaimer-for-links%3Fq%3Dhttps%253A%252F%252Fgithub.com%252Fcloudfoundry%252Fdiego-release%252Freleases%252Ftag%252Fv1.29.1">v1.29.1</a></li> <li><a href="https%3A%2F%2Fhelp.sap.com%2Fviewer%2Fdisclaimer-for-links%3Fq%3Dhttps%253A%252F%252Fgithub.com%252Fcloudfoundry%252Fdiego-release%252Freleases%252Ftag%252Fv1.29.2">v1.29.2</a></li> <li><a href="https%3A%2F%2Fhelp.sap.com%2Fviewer%2Fdisclaimer-for-links%3Fq%3Dhttps%253A%252F%252Fgithub.com%252Fcloudfoundry%252Fdiego-release%252Freleases%252Ftag%252Fv1.30.0">v1.30.0</a></li> </ul> <p>Action: Restart your applications and databases. See <em>Restarting Applications and Databases</em>.</p> <p>Neo • Required • General Availability • New</p> <p><strong>Node.js Buildpack</strong> - New Version</p> <p>The Node.js buildpack has been updated from v1.6.10 to v1.6.12. See changelog from Cloud Foundry repository: <a href="https%3A%2F%2Fhelp.sap.com%2Fviewer%2Fdisclaimer-for-links%3Fq%3Dhttps%253A%252F%252Fgithub.com%252Fcloudfoundry%252Fnodejs-buildpack%252Freleases%252Ftag%252Fv1.6.12">v1.6.12</a>.</p> <p>Neo • Info only • General Availability • New</p> </div> </div>

New Version Added

Announce that a new version is added to the list of available versions.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p><component> version is now available. <Optional short description of the new version and/or how customers can migrate to it>. See <link>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>Login Widget</strong> - New Version</p> <p>A new version of the widget is available in the <em>Site Designer</em> widget gallery. You can find the <em>Login Widget</em> under <em>Standard Widgets: Advanced</em>. See <em>Widgets</em>.</p> <p>Neo • Info only • General Availability • New</p> </div> </div>

New Component Added

Announce that a new component (environment, service, feature, etc.) is added to the list of available components.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p>A new <component> is available for/in <tasks, features, geographical location, etc.>. <Optional, additional description within 1-2 sentences> See <link to service product page or service deliverable>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>Cryptographic Keys and Certificates</strong> - Keystore REST API</p> <p>A new REST API is available for managing cryptographic keys and certificates in your applications. You can use the API alternatively to the available console commands. See <em>Keystore API</em>.</p> <p>Neo • Info only • General Availability • New</p> <p><strong>SAP Application Logging Service</strong> - New Service</p> <p>A new SAP Application Logging service is now available for creating, storing, accessing, and analyzing application logs. See <a href="https%3A%2F%2Fhelp.sap.com%2Fdocs%2Fapplication-logging-service%3Fversion%3DCloud">SAP Application Logging Service for SAP BTP</a>.</p> <p>Cloud Foundry • Info only • General Availability • New</p> </div> </div>

New Region Added

Announce that a new region is available.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong>Region</strong> - <Region Name></p> <p><region name> <(technical key)> is now available as a new region running on <data center provider> for use with <trial and/or enterprise> accounts. See <a href="https%3A%2F%2Fhelp.sap.com%2Fproducts%2FBTP%2F65de2977205c403bbc107264b8eccf4b%2F350356d1dc314d3199dca15bd2ab9b0e.html%23loiof344a57233d34199b2123b9620d0bb41">Regions</a>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> <p><strong>Region</strong> - <Region Name></p> <p><region name> <(technical key)> is now available as a new region for use with <trial and/or enterprise> accounts. See <a href="https%3A%2F%2Fhelp.sap.com%2Fproducts%2FBTP%2F65de2977205c403bbc107264b8eccf4b%2F350356d1dc314d3199dca15bd2ab9b0e.html%23loiof344a57233d34199b2123b9620d0bb41">Regions</a>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>Region</strong> - Europe (Amsterdam)</p> <p>Europe (Amsterdam) (neo-eu3) is now available as a new region for use with enterprise accounts. See <a href="https%3A%2F%2Fhelp.sap.com%2Fproducts%2FBTP%2F65de2977205c403bbc107264b8eccf4b%2F350356d1dc314d3199dca15bd2ab9b0e.html%23loiof344a57233d34199b2123b9620d0bb41">Regions</a>.</p> <p>Neo • Info only • General Availability • New</p> <p><strong>Region</strong> - Europe (Frankfurt)</p> <p>Europe (Frankfurt) (cf-eu10) is now available as a new region running on Amazon Web Services for use with enterprise and trial accounts. See <a href="https%3A%2F%2Fhelp.sap.com%2Fproducts%2FBTP%2F65de2977205c403bbc107264b8eccf4b%2F350356d1dc314d3199dca15bd2ab9b0e.html%23loiof344a57233d34199b2123b9620d0bb41">Regions</a>.</p> <p>Cloud Foundry • Info only • General Availability • New</p> <p><strong>Region</strong> - US West (CA)</p> <p>US West (CA) (cf-us30) is now available as a new region running on Microsoft Azure for use with enterprise and trial accounts. See <a href="https%3A%2F%2Fhelp.sap.com%2Fproducts%2FBTP%2F65de2977205c403bbc107264b8eccf4b%2F350356d1dc314d3199dca15bd2ab9b0e.html%23loiof344a57233d34199b2123b9620d0bb41">Regions</a>.</p> <p>Cloud Foundry • Info only • General Availability • New</p> </div> </div>

Component Renamed

You announce that your component (service) is renamed.

Action Item: Please also replace the old component name in the Component column of the What’s New viewer with the new name for the entries that have been created before the actual renaming took place.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - Component/Service/Product Renaming</p> <p><old component name> is now renamed to <new component name>.</p> <p><(Optional) Some other description about the new service.></p> <p>See <link to the product page></p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>SAP Datasphere</strong> – Service Renaming</p> <p>SAP Data Warehouse Cloud service is now renamed to SAP Datasphere.</p> <p>SAP Datasphere includes the following major new features:</p> <ul> <li>Replication Flows - Load data with both batch and delta functionality from your source systems with a single flow.</li> <li>Catalog - Enable self-service discovery of data and analytic assets, glossaries and terms, and key performance indicators.</li> <li>Analytic Models - Combine, filter, and enrich your analytical datasets and dimensions to produce business-ready models optimized for consumption in SAP Analytics Cloud.</li> </ul> <p>See <a href="https%3A%2F%2Fhelp.sap.com%2Fdocs%2FSAP_DATASPHERE">SAP Datasphere</a>.</p> <p>Cloud Foundry • Info • General Availability • Changed</p> </div> </div>

Old Feature, Resource, or Version Deprecated or Deleted

Announce that something is discontinued and will be deleted. The date should be the actual date of the deprecation. For example, you announce today that a feature will be deprecated in 2 months. Then, the date of the release note will be for after two months.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p><component version> is/will be deprecated as of <date>. <Recommend what customers should do if they are still using the old version or other customer implications>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p>TLS - TLS 1.0 and 1.1</p> <p>We discontinue the support of TLS 1.0 and TLS 1.1 protocols on the default web domain of the EU3 region, *.<a href="http%3A%2F%2Feu3.hana.ondemand.com%2F">eu3.hana.ondemand.com</a>. For more information, see <em>Transport Layer Security (TLS) Connectivity Support</em> section in <a href="https%3A%2F%2Fhelp.sap.com%2Fdocs%2FBTP%2F65de2977205c403bbc107264b8eccf4b%2Fe129aa20c78c4a9fb379b9803b02e5f6.html%3Fversion%3DCloud">Security</a>.</p> <p>If you need support of TLS 1.0 or TLS 1.1 in your applications, you can use custom domains configured for that. See <em>Create an SSL Host</em>.</p> <p>Cloud Foundry • Info only • Deprecated • Changed</p> </div> </div>

You should prepare another release note with lifecycle Deleted when the version is to be completely removed. The date should be the actual date of the deletion.

Changed Feature in Existing Component

Announce that an existing feature is changed.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p><free text>. See <link>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>Tenant Databases</strong> - Memory Consumption</p> <p>The default values for the limitation of the memory consumption in tenant databases are removed. The new default behavior is that no memory limits are set. You can, however, still provide your own values. <em>See Create SAP HANA Tenant Databases</em>.</p> <p>Cloud Foundry • Info only • General Availability • Changed</p> </div> </div>

Old Version Is Out of Maintenance

Announce that a version is no longer maintained or supported.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong><Technical Component></strong> - <Version out of maintenance></p> <p><component version> is out of maintenance. <Optional, recommendation what customers should do if they are still using the old version or other customer implications>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>SAPUI5</strong> - Version 1.28</p> <p>SAPUI5 version 1.28 is out of maintenance and has been removed from the screen for new sites. When editing an existing site that was previously assigned to version 1.28, the assignment in the screen changes to 1.38 automatically upon <em>Save</em>.</p> <p>Action: For version 1.38 to take effect in the runtime as well, you need to publish the site.</p> <p>Neo • Required • Deleted • Changed</p> </div> </div> <div> <div> <p><strong><Technical Component></strong> - <Title></p> <p><component version> is no longer supported. <Optional, recommendation what customers should do if they are still using the old version or other customer implications>.</p> <p><Environment> • <Action> • <Lifecycle> • <Type></p> </div> <div> <p><strong>Java Runtimes</strong> - SAP JVM 6</p> <p>SAP JVM 6 is no longer supported. This means that:</p> <ul> <li>You will not be able to deploy applications with SAP JVM 6 to the platform.</li> <li>SAP JVM 6 is removed for download from the <a href="https%3A%2F%2Ftools.hana.ondemand.com%2F%23cloud">SAP Development Tools</a> Web site.</li> </ul> <p>See <em>Discontinuing Support of SAP JVM6 in the Neo Environment of SAP Cloud Platform Information.</em></p> <p>Neo • Info only • Deprecated • Changed</p> </div> </div>

Announcement of Existing Old Components

You should announce that an old component still exists even though it doesn't have release notes for the current What's New viewer. For such an announcement, you just inform customers that there have been no new release notes yet. You do this by adding a new row with the Add New Row button in loio4917542b0c9749739b955a33b2453077. You then provide the values in the Component and Environment columns. Everything else is pre-configured with the template.

<div> <div>Template</div> <div>Example</div> </div> <div> <div> <p><strong>January 1, 2023</strong></p> <p><Technical Component> - No New Content</p> <p>There has been no new content for this component for 2022.</p> <p><Environment> • Info only • General Availability • Announcement</p> </div> <div> <p><strong>January 1, 2023</strong></p> <p>SAP Web IDE - No New Content</p> <p>There has been no new content for this component for 2022.</p> <p>Cloud Foundry; Neo • Info only • General Availability • Announcement</p> </div> </div>

Announcement of Upgrades or Downtimes

You can find the harmonized release calendar for the cloud products at Intelligent Enterprise Suite: Harmonized release calendar for SAP Cloud products. It is recommended that you refer to this note or to the help topic section when announcing any upgrades or downtimes. Please also follow these guidelines:

If the release note is about an upgrade, include the Upgrade term in the title. Example: SAPUI5 - Upgrade to Version 1.102.0
Publish such a release note ahead of time as a preview. It is fine if it's even published a month ahead.
If there is a downtime, please include it in the Description. Also, mention under the action that customers must plan for the downtime ahead of time. Example: Action: Plan for this downtime as soon as possible by performing the following tasks:...
Use Action with value Recommended or Required as you explain in the Description what must be done and how.

Release Notes per Specific IaaS Region

When you provide release notes for a specific region such as China (Shanghai) or NS2, you need to add the referable content suffix from loioace70e70443e446caa330ec48db61b90 to the title.

Example:

Multitarget Applications for Cloud Foundry - Deprecating Shared Domains [China (Shanghai) Region]

The shared domains are now removed from Alibaba Cloud Landscapes. Till now, when the domain was not specified for an application, the MTA deployment service got the first shared domain and used it. After the removal of shared domains in Alibaba Cloud, the application must be configured and the parameter domain must be specified. The MTA deployment service will not resolve the ${default-domain} placeholder on these landscapes any longer. If the placeholder is being used, you should change it to ${domain} placeholder and additionally specify a domain for each module. Alternatively, the routes parameter could be used which requires the domain to be part of the route.

Standards

Follow the S&Gs and the PCA guidelines. See Standards and Guidelines for User Assistance at SAP. You can find PCA guidelines on the PCA Jam site.
Use the correct and "official" product/service offering names, according to the Approved Names list.

Style

Use active voice as much as possible.
Use the second person pronoun you. Avoid using the third person.
Keep notes short (the recommendation is one or two sentences).
Provide the most essential information in the note.
Leave details for a reference topic and link to it.
Use short sentences.
Choose short words.

false

You can configure the setting. Select the Do It button, and adjust the options.

dont

false

Customers can configure the setting.
The setting can be configured by users with the administrator role by adjusting the options on the Options dialog that can be opened by selecting the Do It button which is accessible on the Whatever page of the cockpit.

Terminology

Avoid using the following terminology:

Self-service - the term self-service does not make sense in the documentation. Everything that users do in the cockpit is a self-service. There is no need to complicate the text so much.
Use the terms approved in Glossary or SAPterm.

Consistency

Stick to the same style across all your notes and in all release notes by others. For example, do not write the first two release notes with one style, and the others with another.
Across all SAP BTP notes: Check the other notes and try to stick to the approach and style that they are using.

Proper Wording and Grammar

Be precise. When you describe a fix that leads to an improvement, provide qualitative information.
No errors. No spelling errors. No grammatical errors. No factual errors. There is nothing more belittling for an entity (company or person) than a text with errors. So please, check spelling, grammar, and facts. Also, use our copy editor Rachi Ofir.
Choose the right words. See Example 2 in Examples with Recommendations for Improvements.

false

The performance is improved three times. The operation is executed for 3 ms now.

dont

false

The performance is faster.

Examples with Recommendations for Improvements

Example 1

Cloud Integration - Validation Step Introduced for JSON-to-XML Converter

The JSON-to-XML converter now checks for each JSON member name if its name can be converted into a valid XML element or attribute name. If this is not the case, an exception is thrown.

Action: Check if your existing integration scenarios have processed invalid XML element or attribute names before.

The introduced enhancement can have an impact on existing integration flows containing the previous version of the JSON-to-XML converter.

Scenarios that have processed invalid XML element or attribute names before can now result in an error due to the newly introduced validation check. If that's the case, you can contact SAP to withdraw the enhancement.

See:

Limitations for JSON to XML Conversion
3112970 - JSON-to-XML Converter Exception Caused by Invalid JSON Member Name (Knowledge Base Article)

Neo, Cloud Foundry • Recommended • General Availability • Changed

Issues

This release note describes the recommended action well, but it does not clarify how the customer has to achieve it: it does not say how to or whom to contact for this roll-back.

Better

Cloud Integration - Validation Step Introduced for JSON-to-XML Converter

The JSON-to-XML converter now checks for each JSON member name if its name can be converted into a valid XML element or attribute name. If this is not the case, an exception is thrown.

Action: Check if your existing integration scenarios have processed invalid XML element or attribute names before.

The introduced enhancement can have an impact on existing integration flows containing the previous version of the JSON-to-XML converter.

See:

Limitations for JSON to XML Conversion
3112970 - JSON-to-XML Converter Exception Caused by Invalid JSON Member Name (Knowledge Base Article)

Neo, Cloud Foundry • Recommended • General Availability • Changed

Example 2

SAP Cloud Services - New Commercial Model for SAP BTP Services

SAP is now offering a new consumption-based commercial model, located to find, try, buy, consume, and pay for the usage of a set of eligible SAP cloud services.

To use the consumption-based commercial model, your organization first needs to sign a Cloud Platform Enterprise Agreement (CPEA) with SAP and make a prepaid investment in cloud credits. Your organization does not have to purchase specific subscriptions in advance for the services that you plan to use. All eligible services are entitled, but nothing is charged until usage begins and then you pay only for the actual usage of the eligible services.

When you set up an account with the consumption-based model, there are no predefined quotas to limit usage. You assign entitlements to services in subaccounts to regulate and monitor how the eligible cloud services are used throughout the organization.

See https://cloudplatform.sap.com/pricing.html and SAP BTP Onboarding with the Consumption-Based Commercial Model.

Neo, Cloud Foundry • Info only • General Availability • Announcement

Points for Improvement

The type should be New instead of Announcement.
The title is too long.
The title states SAP BTP, which is obvious.
It states the type, which is mentioned above.
It is better to state the nature of the model. For example, Consumption-Based Commercial Model.
The content is too long. It contains 143 words and 888 characters, which is hard to scan.
We should avoid speaking about SAP in the third person. That might be necessary only if we are mentioning a third-party vendor. Say "We" instead.
It might be better to simplify the text. For example, “…a new consumption-based commercial model located to find, try, buy, consume, and pay for the usage of a set in Amsterdam, Europe.” Maybe, we can say here, "...a new consumption-based commercial model offered in Amsterdam, Europe to test and pay for the usage."
Some details might be omitted and included in the referenced topic. For example, “To use the consumption-based commercial model, your organization first needs to sign an SAP BTP Enterprise Agreement with SAP and make a prepaid investment in cloud credits.”
The text should be copy edited by Rachi Ofir. See steps 2 and 3 at Steps for Authors.

Better

The following text is shorter, faster to read, more focused, and conveys better the introduction of a new commercial model.

Consumption Based Commercial Model - Services

The new commercial model allows you to prepay a certain amount and then expend it over time for the services that you use. Nothing is charged until usage begins, and then you pay only for the actual usage. There are no predefined quotas. You assign services in subaccounts to regulate and monitor how the services are used. See SAP BTP Onboarding with the Consumption-Based Commercial Model.

Neo, Cloud Foundry • Info only • General Availability • New

Example 3

Feature Flag Service - Inventory

You can now move your feature flags inventory to a new instance with the following:

Export the data from the old service instance
Provide the exported data as configuration when you create a new service instance

More details about this process can be found here <link to documentation>.

Neo • Info only • General Availability • New

Points for Improvement

The word “move” implies that after the action the inventory will not be at the original place. This is not true. The inventory is in fact copied to a new service instance.
We use bullets, yet the bullets represent two consecutive steps. If we use a list here, it must be numbered. Since these are just two steps, it is perfectly OK to use regular sentences.
For the link, use See <link to documentation>.

Better

Feature Flag Service - Feature-Flag Inventory

You can use existing feature-flag inventories in new service instances. First, export the desired inventory from an instance. Then, when creating the new instance, provide the exported data as configuration. See <link to documentation>.

Neo • Info only • General Availability • New

Example 4

SAP BTP Cockpit - Subscriptions

Using the cockpit, you can manage your subscriptions to SaaS multitenant business applications in the Cloud Foundry environment. A new entry, Subscriptions, is available in the cockpit navigation menu in your Cloud Foundry subaccount. This screen lists all the SaaS business applications, for which you have purchased a license from SAP, in your Cloud Foundry account. Here, you can also view the applications that you currently subscribed to, create and remove subscriptions, and launch subscribed applications.

You can use the cockpit to view the list of application roles that have been defined for a subscribed application by navigating to the Roles tab of the subscribed application. See Managing Subscriptions and Managing Application Subscriptions in Cloud Foundry.

Cloud Foundry • Info only • General Availability • New

Points for Improvement

Some terminology might not be correct. For example, Cloud Foundry subaccount, cockpit navigation menu, or SaaS business applications. We should check with Brand Voice or SAPterm what terms are acceptable.
We should refer to topics that are relevant for or describe the new feature. It is not necessary to link to a general concept topic.

Better

SAP BTP Cockpit - Subscriptions

Subscriptions are now available in the Cloud Foundry environment. The page lists all applications to which your subaccount is subscribed.

You can also view the list of application roles defined for a subscribed application: go to the tab of the subscribed application. See Managing Application Subscriptions in Cloud Foundry.

Cloud Foundry • Info only • General Availability • New

Example 5

SAP HANA - Database Explorer

The SAP HANA database explorer is integrated into both the SAP HANA cockpit service and the SAP Web IDE for SAP HANA service. The database explorer allows you to execute SQL statements and database procedures, query information about the database, and view information about database catalog objects. See SAP Note 2485954. For more information about the database explorer for the Cloud Foundry environment, see SAP HANA Database Explorer.

Cloud Foundry • Info only • General Availability • New

Points for Improvement

What is the news here? How is it related to the platform? It is not clear what we are saying.
The link to “SAP Note 2485954” is broken. We need to replace “%23” with “#” in the URL. “SAP Note 2485954” does not provide anything additional. It gives the exact same two sentences that we have given here. What is the point of referencing the note?
Topic “SAP HANA Database Explorer” does not exist. The link points to a topic called “SAP HANA Database Explorer and SQL Analyzer”, which topic is virtually empty. Maybe it will be better to link to About the SAP HANA Database Explorer and the SQL Analyzer because that topic explains what is what.

Better

SAP HANA - Database Explorer

The SAP HANA database explorer is now available for use with SAP HANA cockpit and SAP Web IDE for SAP HANA. The database explorer allows you to execute SQL statements and database procedures, query information about the database, and view information about database catalog objects. See About the SAP HANA Database Explorer and the SQL Analyzer.

Cloud Foundry • Info only • General Availability • New

Example 6

Trading Platform Integration - Changes to Business Rules regarding Account Assignment

You can now differentiate between leg 1 and leg 2 for the account assignment attributes in the input structure of all relevant business rules. The following rules are subject to this change:

Decision for Trade Request Routing Category
Decision for Intercompany Trading Scenario
Decision for Foreign Exchange Instrument Category
Derivation of Trading Partners
Decision for Foreign Exchange Instrument Category
Decision for Trading Scenario
Decision for Markup or Markdown
Decision for Quotation Source

Caution
If you have configured any of these rules with conditions based on one of the following assignment fields, you need to activate the rule by selecting the rule and Edit Activate.

Impacted account assignment fields:

hedgingClassification
hedgingArea
portfolio
onBehalfOfCompany
profitCenter
costCenter
wbsElement
businessArea
segment
countryCode
hedgeRequestId
externalReference
assignment
internalReference
characteristics

Additionally, you can differentiate between leg 1 and leg 2 for the account assignment attributes in the input and result structure for the Derivation of Values for Trade Request V2 business rule.

Action: Make the relevant changes in the business rules and activate the rules if necessary.

Cloud Foundry • Recommended • General Availability • Changed

Points for Improvement

This note is too long and our customers complain about having to skim too much content. The author should move the lengthy text to a new topic, or even two topics, and refer to them. The purpose of a release note isn't to explain all of the details of a functionality, but just to inform the user about the feature or concept.
There is no reference for more information. Our customers always expect to find additional information.

Better

Trading Platform Integration - Changes to Business Rules Regarding Account Assignment

You can now differentiate between leg 1 and leg 2 for the account assignment attributes in the input structure of all relevant business rules. See Changes to Business Rules regarding Account Assignment.

Action: Make the relevant changes in the business rules and activate the rules if necessary. See Activate the Rules for Impacted Account Assignment Fields.

Cloud Foundry • Recommended • General Availability • Changed

What's New

Deliverables / SAP Help Portal

Overview

Responsibility

Pattern

Customer Feedback

Experimental Features

Beta Features

Action Definition

Fix

Version Update

New Version Added

New Component Added

New Region Added

Component Renamed

Old Feature, Resource, or Version Deprecated or Deleted

Changed Feature in Existing Component

Old Version Is Out of Maintenance

Announcement of Existing Old Components

Announcement of Upgrades or Downtimes

Release Notes per Specific IaaS Region

Standards

Links

Style

Terminology

Consistency

Proper Wording and Grammar

Examples with Recommendations for Improvements

Example 1

Issues

Better

Example 2

Points for Improvement

Example 3

Points for Improvement

Better

Example 4

Points for Improvement

Example 5

Points for Improvement

Better

Example 6

Points for Improvement

Better