You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Docs should "get to the point" making it easy for anyone to quickly see the content.
The splash screen has a few issues that get in the way of this, that are easy to remedy.
banner image is too large -- takes up 50%+ of the real estate when you get to the page. Every square cm that it takes, is a square cm not for people to see the real content below
banner image says "Welcome to the Ocean docs"; and the H1 Header text right below also says "Welcome". This is redundant, and wastes space. Every square cm...
The H2 text "Help for wherever you are on your Ocean journey" doesn't say much. And it's redundant with the first box below "Discover Ocean" already signals "we're friendly to newcomers" and the other boxes which signal "beyond the newcomers"
banner image is weirdly whited-out. This makes it feel poorer-quality, and inconsistent with images below which aren't whited-out or muted in some other fashion. AFAIK this is recent; it wasn't like that a couple months ago. This isn't just for the splash page, it's for all the pages. More general github issue: #1425. However for this github, one option is to remove the banner image altogether.
Appendix: Screenshots
Here is the splash page with a typical, narrow, and wide browser accordingly. (From a macos running chrome).
Typical
Narrow
Wide
The text was updated successfully, but these errors were encountered:
Summary of issues
This is a UX bug.
Docs should "get to the point" making it easy for anyone to quickly see the content.
The splash screen has a few issues that get in the way of this, that are easy to remedy.
Appendix: Screenshots
Here is the splash page with a typical, narrow, and wide browser accordingly. (From a macos running chrome).
Typical
Narrow
Wide
The text was updated successfully, but these errors were encountered: