quarkusio.github.io icon indicating copy to clipboard operation
quarkusio.github.io copied to clipboard
verified publisher icon quarkusio

Dev UI Homepage Section and Dedicated Page

Open josephaw1022 opened this issue 1 year ago • 13 comments

Adding a Dev UI Page and a section to the home page.

Not done, but this is a good starting point

closes #2174

josephaw1022 avatar Nov 27 '24 21:11 josephaw1022

Thanks @josephaw1022 - I am looking at it. can you please squash your commits into 1. Thanks :)

phillip-kruger avatar Nov 27 '24 21:11 phillip-kruger

@cescoffier ^^^ f.y.i

phillip-kruger avatar Nov 27 '24 21:11 phillip-kruger

🎊 PR Preview 7a39d75736a01ae06349d55030f8340dae8b9202 has been successfully built and deployed to https://quarkus-site-pr-2178-preview.surge.sh

  • Images of blog posts older than 3 months are not available.
  • Newsletters older than 3 months are not available.

github-actions[bot] avatar Nov 27 '24 22:11 github-actions[bot]

@josephaw1022 Looking at https://quarkus-site-pr-2178-preview.surge.sh/version/main/guides/# I can not seem to find the entry point

phillip-kruger avatar Nov 27 '24 22:11 phillip-kruger

As Phillip said, I'm unsure where this page was intended to be accessed. @insectengine, do you have any idea?

Also, please squash your commits.

cescoffier avatar Nov 28 '24 06:11 cescoffier

I can squash the commits later today. The changes are visible on the landing page under features section of the home page for review.

This PR is still a work in progress but is at a point where the direction can be evaluated. I want to ensure it aligns with expectations before investing further effort into potentially unwanted changes. @phillip-kruger @cescoffier

josephaw1022 avatar Nov 28 '24 14:11 josephaw1022

@cescoffier go to https://quarkus-site-pr-2178-preview.surge.sh/ and scroll down then you will see it

phillip-kruger avatar Nov 28 '24 22:11 phillip-kruger

@josephaw1022 we have some extensions that document their part of dev ui in their extension documentation. It might be a good idea to link to them from this new page. Also we need others like @maxandersen and maybe @gsmet to comment on this too.

phillip-kruger avatar Nov 28 '24 22:11 phillip-kruger

@phillip-kruger You definitely are correct regarding the links to the pre-existing pages and documentation on extensions and all that. Definitely can add those in later at some point in this PR.

josephaw1022 avatar Nov 29 '24 00:11 josephaw1022

Overall a great start to this but I have some comments from my perspective.

  1. This type of content should not have a home page band dedicated to it. This seems perfectly to fit in with the "Quarkus Features" band already there, especially since it would fit into the "Why" navigation.

  2. There needs to be some sort of introductory text on the landing page to set up what Dev UI is and why it's important to users. Right now, a user lands on the page and is hit with a laundry list of features/actions.

insectengine avatar Dec 02 '24 14:12 insectengine

To-Do Summary Based on Feedback:

@insectengine

  1. For point 1: Remove the section from the homepage and just use a link under the new "Why" menu item?

  2. For point 2: Add a general description to the second page.

@phillip-kruger

  1. Based on Phillip's feedback: Add relevant links to each section, pointing to the existing Quarkus guides.

josephaw1022 avatar Dec 02 '24 16:12 josephaw1022

as others said this doesn't feel right to have on frontpage.

we have quarkus.io/developer-joy that talks about devui - maybe there ? or on a dedicated quarkus.io/developer-joy/devui page?

maxandersen avatar Dec 11 '24 14:12 maxandersen

Also, would be good to have the "core" features separate from "you need to add extension"-features or at least call it out somewhere.

Also just as another sugggestion - make it part of guides like devservices? https://quarkus.io/guides/dev-services ?

could still have page with the "core" features but have the more detailed stuff in the guides?

maxandersen avatar Dec 11 '24 15:12 maxandersen