[doc issue] Why is Asynchronous Loading both deprecated and recommended?

[ziyang-works]

Issue description

I'm new to UI5 and am currently deciding if I should set data-sap-ui-async="true" for my new UI5 project.

However, I'm finding this option listed as deprecated on Deprecated and Experimental Configuration Options while recommended at Use Asynchronous Loading.

I am a bit confused now. If the option is deprecated, does it mean it could be removed in the future and I should not use it for new projects? If so, why is the option still listed as recommended?

Feedback Type (Optional)

clarity

Page Title on SAP Help Portal (prefilled)

Deprecated and Experimental Configuration Options

Page URL on SAP Help Portal (prefilled)

https://sapui5.hana.ondemand.com/sdk/#/topic/b474a712ca364d40a1b0a804baf2d734

[KvM2]

Hi @ziyang-works , thanks for your contribution . We appreciate it and will look into this.

[KlattG]

Hi @ziyang-works , thank you for your patience. We understand that a more accurate listing of deprecated config parameters is required for our documentation. We are working on your concern and will be updating the documentation soon.

[KlattG]

Classification of the async option will be fixed in one of the next patch sets / next release.

[sap-doc-bot]

Thank you for your valuable feedback contribution, @ziyang-works! So that we can recognize your contribution in SAP Community, please tell us your SAP Community profile URL in a reply to this comment; don't include any other text, just the URL on its own, like this:

https://people.sap.com/your-user-name

Thanks!