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
92 stars 144 forks source link

Double `#` in the URL on a link on `https://sdk.openui5.org/nightly` #77

Closed pubmikeb closed 1 year ago

pubmikeb commented 1 year ago

Issue description

If we check the description of sap.ui.core.Core.byId, we find out that this method is deprecated:

Deprecated as of version 1.119. Please use Element.getElementById instead.

We click on a proposed link and everything is OK.

However, in case of https://sdk.openui5.org/nightly/#/api/sap.ui.core.Core%23methods/byId, the proposed link contains an extra #: https://sdk.openui5.org/nightly/#/#api/sap.ui.core.Element%23methods/sap.ui.core.Element.getElementById, and this link is wrong, leading to the error:

The requested resource was not found.

The correct link is:

https://sdk.openui5.org/nightly/#/api/sap.ui.core.Element%23methods/sap.ui.core.Element.getElementById

Feedback Type (Optional)

linking

Page Title on SAP Help Portal (prefilled)

class sap.ui.core.Core.byId

Page URL on SAP Help Portal (prefilled)

https://sdk.openui5.org/nightly/#/api/sap.ui.core.Core%23methods/byId

pubmikeb commented 1 year ago

Initially, I've reported this issue on https://github.com/SAP/openui5-docs/issues/89, but that project looks like abandoned — the latest closed issue is marked by Feb 17, 2023.

KvM2 commented 1 year ago

Hi @pubmikeb , thanks for your contribution. We appreciate it and will look into this. This is actually not about the developer guide, but about API docu, but I will pass it on.

pubmikeb commented 1 year ago

This is actually not about the developer guide, but about API docu, but I will pass it on.

hi, @KvM2, for the future reports, where should I file API docu-related issues?

pubmikeb commented 1 year ago

This is actually not about the developer guide, but about API docu, but I will pass it on.

Hi @KvM2, for the future reports, where should I file API docu-related issues?

KvM2 commented 1 year ago

Hi @pubmikeb, you can use the Demo Kit feedback channel for these. If you don't know this feature: You can find it in the Demo Kit under More information (cogwheel) and then select Give Feedback . It also gives you the option to do this in a context-sensitive way for a particular page.

pubmikeb commented 1 year ago

You can find it in the Demo Kit under More information (cogwheel) and then select Give Feedback .

Starting the 1.120.0 version, there is no such option as Give Feedback:

26_123013

KvM2 commented 1 year ago

Seems you are in the internal Demo Kit. 🙂 I was referring to the external Demo Kit.

pubmikeb commented 1 year ago

Seems you are in the internal Demo Kit.

OK, so Give Feedback is available on GA/RTM docs only. I assumed that a Give Feedback functionality has been just entirely removed. Let's wait another couple of weeks until 1.120.0 goes to GA and check if Give Feedback will be still available on external Demo Kit.

boghyon commented 1 year ago

@pubmikeb

The issue seems to be fixed. Could you check again?


Regarding other comments..:

Initially, I've reported this issue on https://github.com/SAP/openui5-docs/issues/89, but that project looks like abandoned

I just published a new PR at https://github.com/SAP/openui5-docs/pull/90. Since OpenUI5 is the core of SAPUI5, I prefer contributing to the openui5-docs repo. Only if the change covers SAPUI5 exclusive content, then here in this SAPUI5 docs repo. In the end, it doesn't really matter. The maintainers are very active in both repos! :)

[...] where should I file API docu-related issues?

API reference is generated from JSDoc as part of the UI5 source code. If the API is from OpenUI5 (incl. the code for the OpenUI5 Demo Kit, OpenUI5 samples, etc.), file the issue at https://github.com/SAP/openui5

I assumed that a Give Feedback functionality has been just entirely removed.

I think so too. Also in the stable 1.119 release, the classic "Give Feedback" dialog is gone. :(

pubmikeb commented 1 year ago

@boghyon,

The issue seems to be fixed. Could you check again?

I've just checked the content of https://sdk.openui5.org/nightly/#/api/sap.ui.core.Core%23methods/byId and it looks like the link Element.getElementById still contains double #:

https://sdk.openui5.org/nightly/#/#api/sap.ui.core.Element%23methods/sap.ui.core.Element.getElementById

Perhaps, the fix has not been yet applied to the source code.

OlMue commented 1 year ago

I've just checked the content of https://sdk.openui5.org/nightly/#/api/sap.ui.core.Core%23methods/byId and it looks like the link Element.getElementById still contains double #:

https://sdk.openui5.org/nightly/#/#api/sap.ui.core.Element%23methods/sap.ui.core.Element.getElementById

Perhaps, the fix has not been yet applied to the source code.

Hi @pubmikeb, this is a bit strange. Everything looks and behaves fine in the official version of 1.119 that has been released by now, i.e. https://sdk.openui5.org/api/sap.ui.core.Core#methods/byId. So that's fine.

However, in the nightly version which already reflects the dev state of 1.120, the behavior is incorrect. The strange thing is that the URL looks alright in the status bar when I hover over the link:

image

When I (left-)click on it, it's also fine at first and opens the correct page. However, opening it with a right-click still leads to the URL with the double #. And when I go back to the initial page for the byId method, it's also wrong in the status bar.

Weird. I'll address this with the Demo Kit team. I will also close this issue since it's apparently fixed in the official (non-nightly) version.