Skip to content

[Other]: Some ideas to improve the site #1021

Closed as not planned
Closed as not planned
@amirhhashemi

Description

@amirhhashemi

📋 Explain your issue

I have a few ideas for improving the documentation site. I understand that you are transitioning to a new site, so some of these suggestions may no longer be relevant. However, I wanted to share them in case they haven't been considered yet.

Some of the points I mention are bugs. I would be glad to assist you in fixing them if you would like.

image
This should probably be labeled "Solid" instead of "Core," as "Core" is a bit ambiguous.

Pasted image 20250112155213
Pasted image 20250112154920
Pasted image 20250112154935
I prefer not to mix different font weights in headings like this, as it makes them look unbalanced. If you want to emphasize a specific word, consider changing its color or using other elements like an underline.

Pasted image 20250112155754
This button draws more attention than the "Get Started" button. It appears fine in dark mode, though. It seems to be a bug in the light mode code.

Pasted image 20250112160700
This ball is not centered within the line.

Pasted image 20250112161355
Pasted image 20250112161156
I dislike using font-bold to indicate the active section on a page because it causes layout shifts. For instance, "Exposing a tRPC server route" normally displays on one line, but when it’s selected, it expands to two lines, pushing down all the content below. Instead, consider changing the color and possibly adding a small ball or line on the left to indicate the active section.

Pasted image 20250112162205
If you look closely, there’s a command after bind that is concealed under the border. Please remove the border and change the text color to indicate that it's a link.

Pasted image 20250112162626
The background color of these code blocks stands out far more than necessary. I suggest using a lighter shade of blue.

Pasted image 20250112162534
It would make more sense for the "Previous" and "Next" buttons to be lighter than the links below them.

Pasted image 20250112163906
Headings that are links don't look like how links should. It should have a blue underline.

Metadata

Metadata

Assignees

No one assigned

    Labels

    pending reviewAwaiting review by team members.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions