Skip to content

Use a boring old table for documentation links - #183

Closed
robobario wants to merge 1 commit into
kroxylicious:mainfrom
robobario:documentation-page-table
Closed

Use a boring old table for documentation links#183
robobario wants to merge 1 commit into
kroxylicious:mainfrom
robobario:documentation-page-table

Conversation

@robobario

@robobario robobario commented Aug 5, 2025

Copy link
Copy Markdown
Member

Cards were getting big v0.14.0 is going to introduce even more. Even nicer might be a tree like arrangement with quickstarts/guides/other grouped together.

Before:
Screenshot From 2025-08-05 17-24-40

After:
Screenshot From 2025-08-05 17-23-37

Cards were getting big. Even nicer might be a tree like arrangement with
quickstarts/guides/other grouped together.

Signed-off-by: Robert Young <robertyoungnz@gmail.com>
@robobario
robobario requested a review from a team as a code owner August 5, 2025 05:26
@tombentley

Copy link
Copy Markdown
Member

I agree that the number of guides is becoming a bit of a problem. But I'm not sure switching to a table is this best way to tackle this. It make the page less visually appealing.

  • I'd like to move more in the direction of what quarkus has (see here), making use of the documentation metadata (e.g. tags), so visitors can easily select content based on what they're trying to achieve. I don't think we need their text search functionality yet though.
  • I'd also like to make these page a bit more visually interesting with icons, e.g Duke for stuff aimed at Java programmers, the Kube ships wheel icon for kube stuff, and maybe the Kroxylicious crocodile for straight proxy stuff? We'd need to confirm that using these icons like this is OK per the wishes of the the trademark owners. I think it is, but let's point to something specific in any PR which does this so we have a record that we did it.

@robobario

Copy link
Copy Markdown
Member Author

fair enough, maybe they could just be compacted slightly. Instead of text search maybe it would be nice to be able to filter them by purpose like you've said, like if the same icons were up at the top or side bar, and clicking them reduced it down to only developer or k8s cards

@robobario robobario closed this Aug 8, 2025
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.

2 participants