Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Dev UI Homepage Section and Dedicated Page #2178

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

josephaw1022
Copy link

@josephaw1022 josephaw1022 commented Nov 27, 2024

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

Not done, but this is a good starting point

closes #2174

@josephaw1022 josephaw1022 changed the title Dev UI section and page Dev UI Homepage Section and Dedicated Page Nov 27, 2024
@phillip-kruger
Copy link
Member

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

@phillip-kruger
Copy link
Member

@cescoffier ^^^ f.y.i

Copy link

github-actions bot commented Nov 27, 2024

🎊 PR Preview 7a39d75 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.

@phillip-kruger
Copy link
Member

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

@cescoffier
Copy link
Member

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.

@josephaw1022
Copy link
Author

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

@phillip-kruger
Copy link
Member

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

@phillip-kruger
Copy link
Member

phillip-kruger commented Nov 28, 2024

@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.

@josephaw1022
Copy link
Author

@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.

add dev ui to the homepage

add styling for section to the main.scss file

images for section and potentially new page

fix wording on single card and adjust card styling in general

get the html to look somewhat decent. not done but its good enough for now

new bare bone html page (nothing in it)

dev ui page and its sections

add border top to the section

add new sections to the dev ui  (config, kubernetes yaml, visualize endpoints)

consolidate styling for new and existing sections

fix wording on single card and adjust card styling in general

get the html to look somewhat decent. not done but its good enough for now

Sync documentation of main branch

Sync working groups

format dev ui page the way the other "why" pages are formatted

Sync documentation of main branch

fill out rest of the sections for dev ui page
@insectengine
Copy link
Collaborator

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.

@josephaw1022
Copy link
Author

josephaw1022 commented Dec 2, 2024

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Enhance Dev UI Visibility with Dedicated Page and Homepage Section
4 participants