search

SAP-docs / sapui5

This is the markdown version of the official SAPUI5 documentation from the SAPUI5 Demo Kit for external contributions.
Creative Commons Attribution 4.0 International
71 stars 116 forks source link

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

Closed ziyang-works closed 5 months ago

ziyang-works commented 6 months ago

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.

image image

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 commented 6 months ago

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

KlattG commented 5 months ago

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 commented 5 months ago

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

sap-doc-bot[bot] commented 4 months ago

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!