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

Add header images to tutorials and guides #198

Open
MattatDirectus opened this issue Mar 5, 2025 · 6 comments
Open

Add header images to tutorials and guides #198

MattatDirectus opened this issue Mar 5, 2025 · 6 comments

Comments

@MattatDirectus
Copy link

Currently there is a lot of text, and it is hard to navigate this section without getting a bit overwhelmed.

Image

I think a good way to set-up this section is similar to how Bryant built the content rep for us -

Image

Makes it much more engaging and easy to find what I want (filters, tags, etc.)

Copy link

linear bot commented Mar 5, 2025

@hola-soy-milk
Copy link
Contributor

Thank you for this, @MattatDirectus! This has been brought up by @hanneskuettner as well, that the cards are hard to read.

Given that these docs were built with the intent of forgoing the header images, I'd lean towards shifting this view to have more of a list-like look.

Would appreciate any thoughts, please!

@MattatDirectus
Copy link
Author

Oh, interesting - did not realize it was by design. Any specific reason why you opted to forgo images?
To me, the first thing I'm going to see/notice are the big logos I know - Next.js, Nuxt, Vue, etc. That's what captures my attention, and its easier to visually sift through a page vs. text alone.

@hola-soy-milk
Copy link
Contributor

Thanks, @MattatDirectus! This was not my decision, but Kevin's. @rijkvanzanten any chance you know why?

@bryantgillespie
Copy link
Member

Throwing my hat in the ring on this one. Very difficult to parse this Tutorials page and find relevant the items with the current layout and lack of images. Especially since a lot of the article titles are super similar.

Even if we move to a "list" instead of a "grid", I'd like to see the images return because they add important context.

@phazonoverload
Copy link
Contributor

Making images is a pain in the ass. That's basically it. The original redesign had technology tags as nice lil icons which made these much kinder on the eye.

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

4 participants