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

Revise overview page #5925

Open
jgawor opened this issue Oct 18, 2022 · 2 comments
Open

Revise overview page #5925

jgawor opened this issue Oct 18, 2022 · 2 comments
Assignees

Comments

@jgawor
Copy link

jgawor commented Oct 18, 2022

The docs page (https://openliberty.io/docs/latest/overview.html) has a lot of good content. However, a lot of that TOC is off-screen when initially viewing the page and user needs to scroll to see all the important topics. I think the "Welcome to Docs" page can be improved to show the key (or popular) topics right on that page - e.g. assembled in a set of tables. Example: https://learn.microsoft.com/en-us/azure/developer/java/ee/

@dmuelle dmuelle added this to the 22.0.0.12 milestone Oct 19, 2022
@dmuelle dmuelle changed the title Better TOC for docs Sitemap for overview page Oct 19, 2022
@dmuelle dmuelle modified the milestones: 22.0.0.12, 22.0.0.13 Nov 10, 2022
@dmuelle dmuelle self-assigned this Nov 30, 2022
@dmuelle dmuelle modified the milestones: 22.0.0.13, 23.0.0.1 Dec 2, 2022
@dmuelle dmuelle changed the title Sitemap for overview page Revise overview page Jan 10, 2023
@dmuelle dmuelle modified the milestones: 23.0.0.1, 23.0.0.2 Feb 1, 2023
@dmuelle
Copy link
Member

dmuelle commented May 4, 2023

OpenLiberty/openliberty.io#3151 issue to add whatsnew content automatically to this page

@dmuelle dmuelle added this to the 23.0.0.10 milestone Sep 21, 2023
@dmuelle
Copy link
Member

dmuelle commented Sep 22, 2023

This issue was discussed again at the site meeting on 9/21, as the website team now has access to some design resources in Austin that might be able to help us with the page. Ideas for improvement include:

  • tiles/ cards design to make the page more engaging
  • dynamic updates for whats new in each release, sourced from the release blog post- basically some filtered reduced version of the https://openliberty.io/blog/?search=release blogroll (excluding beta content)
  • summary/expanations of the content in each section of the TOC (Basics, Development, Security, Operations, Deployment, Reference)
  • Calling out high value/traffic topics

@dmuelle dmuelle modified the milestones: 23.0.0.10, 23.0.0.11 Oct 3, 2023
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

No branches or pull requests

2 participants