redesign docs page #242
redesign docs page #242
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
|
Wondering if it's a bite too much whitespace, a bit too reduced. Does it work better if you have two boxes side-by side on large monitors? What about making each headline a different color? |
|
If we change the margin on 
A grid layout could work but we have to be very careful — they get super awkward when the copy is of variable length (in other words it becomes a future maintenance burden, when adding new sections etc): 
We definitely shouldn't change the headline colour, we need typographical consistency or everything will start to look very chaotic in short order |
|
Spaced out much better now. Only thing left is whether or not we should add some more touches to it. Right now it's just text. Like, should it have an icon before each, or a gradient background going from one color to another? I don't know, maybe it's fine like this and I'm just used to pages with more stuff going on. |
|
|
(this is a quote you will hear frequently in design circles, and it's 100% true, I cannot count the time I have witnessed designers take something mediocre and turn it into something beautiful just by removing stuff) |
| <h2>Help! I'm stuck</h2> | ||
| <p> | ||
| Join our Discord server where you can hang out with fellow Svelte users and ask them | ||
| questions. It's like an LLM but with people. |
There was a problem hiding this comment.
Let's lose the LLM bit. It might also be good to reference github discussions too
There was a problem hiding this comment.
GitHub discussions is a venue for discussing the evolution of the project, more than a place to find help. The last thing we want to say to someone who's stuck is 'here are multiple options!'
What's wrong with the LLM bit? Encouraging mutual aid and community, and contrasting that with solipsistic hallucination machines, feels in line with our values. (Though I do intend to add another item to this list — 'I'm an artificial intelligence' — with a link to the one pager. Which I've just realised we don't have an issue for.)
There was a problem hiding this comment.
I too find the LLM bit funny and have no problem with it being there.
|
My only gripe is the arrow being on the right. My eyes just don't reach for it, and the sections don't look like links, maybe make it clearer that these are links to other sections? Interestingly, in dark mode it looks fine tho? |
|
Ha — I didn't realise it looked like that in dark mode, I didn't intend to have those boxes. Without the icons, or at least without something, everything feels arbitrarily off-centered: 
What that 'something' is could change, but we should avoid the easy fix of putting things in boxes or having horizontal boundaries. |
|
@Rich-Harris It's fine on desktop as you can hover to discover it's a link. However, I first viewed this on my iPhone so it wasn't as clear – the orange arrows don't really stand out on a white background so well. |
|
I'm surprised by that — the arrows are the same colour as the links elsewhere (except body copy) precisely to communicate that they're links. I just pushed a change that increases the brightness a smidge, hopefully that provides sufficient contrast with the text |
|
merging in the spirit of incrementalism, as there's some stuff in here that will unblock other work |
|
Once we have docs for all the other projects I wonder how we'll end up including them here |
4 participants
closes #102. There's lots of different directions we could go with this, this is just one proposal.