Created attachment 165950 [details] A screenshot of the 404 page SUMMARY I've been trying to learn to make apps with the Kirigami framework, and I noticed that just about none of the API reference links were working. I always get a 404 Not Found page. There was a link to the right of the screen to report a "documentation issue," which I assumed this was, but the link sent me to invent.kde.org, where there was a big red banner telling me to report this here instead. STEPS TO REPRODUCE 1. Go to develop.kde.org/docs/getting-started/kirigami/components-pagerow_pagestack/ (I'm using Vivaldi as my browser, but I'm assuming that that is insignificant as it's a 404 error.) 2. Click on any API reference link (E.g. the first one, a link to Kirigami.Page) OBSERVED RESULT A 404 page: Not Found The requested URL was not found on this server. Apache/2.4.52 (Ubuntu) Server at api.kde.org Port 443 EXPECTED RESULT The API reference page for the link I clicked SOFTWARE/OS VERSIONS Linux/KDE Plasma: 6.2.0-39-generic (available in About System) KDE Plasma Version: 5.27.4 KDE Frameworks Version: 5.104.0 Qt Version: 5.15.8 ADDITIONAL INFORMATION None
I was about to report the same bug Section link: https://develop.kde.org/docs/getting-started/kirigami/introduction-getting_started/ I will copy the sentences in which I found broken links links - We then come to our base element, Kirigami.ApplicationWindow, which provides some basic features needed for all Kirigami applications - an initially empty stack of pages provided by Kirigami.ApplicationWindow, and with - we set the first page presented upon loading the application to a Kirigami.Page. - In this case, the parent component of our label is Kirigami.Page.
This is a known issue: https://invent.kde.org/documentation/develop-kde-org/-/issues/162#note_965934 The solution will be https://invent.kde.org/frameworks/kapidox/-/issues/25 and https://invent.kde.org/teams/goals/streamlined-application-development-experience/-/issues/10. However, now that we actually have https://api-staging.kde.org/kirigami-index.html now and it's way more useful than the current API docs website, I'll see about adding an alert at the top of the page mentioning that users should refer to https://api-staging.kde.org/kirigami-index.html instead (replacing the links would be duplicated work given the new API docs are staging, so an alert would suffice). I made an issue to track this since it's going to take a bit before I can merge it: https://invent.kde.org/documentation/develop-kde-org/-/issues/209