quarkusio / quarkus

Quarkus: Supersonic Subatomic Java.
https://quarkus.io
Apache License 2.0
13.77k stars 2.68k forks source link

Show the list of endpoints on the default index page #42825

Closed ia3andy closed 1 month ago

ia3andy commented 2 months ago

Describe the bug

Currently it's not obvious how to find the list of available endpoints when opening Quarkus: image

This is very important as we previously had the codestart list with their link and now there is nothing to find it.

Expected behavior

Display the list of endpoint like on the 404 page image

Actual behavior

No response

How to Reproduce?

Create any Quarkus app with a codestart from code.quarkus.io

Output of uname -a or ver

No response

Output of java -version

No response

Quarkus version or git rev

3.14.0

Build tool (ie. output of mvnw --version or gradlew --version)

No response

Additional information

No response

quarkus-bot[bot] commented 2 months ago

/cc @cescoffier (devui), @phillip-kruger (devui,mvnpm)

maxandersen commented 2 months ago

couldn't the page include the readme sections that each codestart contribute to readme ?

they can have more info than just URLs to go visit.

ia3andy commented 2 months ago

Also I think we should sort the list of endpoint by number of / in order to have the direct pages first..

gsmet commented 2 months ago

Could we please not marked as [important] something that's not even a bug?

I agree we can improve but it's really not that important compared to a lot of other things we have in this tracker and I don't think it's worth driving the attention of everyone having a look at issues.

Thanks.

ia3andy commented 2 months ago

I think it's a very severe bug as it means all users starting with Quarkus won't have the right link in their starter app. I wouldn't put [important] if it wasn't..

ia3andy commented 2 months ago

I also added important because it look like a minor issue, but it really isn't

maxandersen commented 2 months ago

It's a bug. Code starts in past could add info to guide users to what to navigate to and what to do.

Relevant for the quick presets added to code.quarkus which now don't show/help the user what to do.

cescoffier commented 2 months ago

The title of an issue should not indicate its priority or importance. Doing so would break tools' building release notes or script reporting activity (typically, I would do the same edit because it messes up my report). We have "priority" labels (blocker and urgent). We could potentially add "important."

However, I'm not totally sure about the "good first issue".

cescoffier commented 2 months ago

BTW, I totally agree it's a bug / regression and we should fix it, and backport it to the LTS.

ia3andy commented 2 months ago

The title of an issue should not indicate its priority or importance. Doing so would break tools' building release notes or script reporting activity (typically, I would do the same edit because it messes up my report). We have "priority" labels (blocker and urgent). We could potentially add "important."

However, I'm not totally sure about the "good first issue".

I should have asked the proper way to mark it as important you are right..

The fix shouldn't be too hard as we already have the 404 page no?

cescoffier commented 2 months ago

It should not be too hard if you are @phillip-kruger .... it can be a bit overwhelming if that's your first contribution.

phillip-kruger commented 2 months ago

I'll have a look

maxandersen commented 2 months ago

lets add link to the readme on local file system from the index page - then I think we are covered well for LTS to enable codestarts to provide context/info to users.

ia3andy commented 2 months ago

and the list of endpoints please :)

phillip-kruger commented 1 month ago

This is done