Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: Feedback on prototype reorganized Zsh website



On 10/27/2024 10:34, Jun. T wrote:
2024/10/24 13:28, Clinton Bunch <cdb_zsh@xxxxxxxxxxx> wote:
There's still a lot of work to do, but before I put in that effort, I'd like some feedback on the new organization and look.

https://zsh.clintonbunch.name/
It looks great both in light and dark modes (color schemes).

The Zshell icon at the top-left corner of the page is used as a link to
go back to the top page. Is this OK for everyone? (it's OK for me).
That seems to be a common web convention and I didn't really like the "navigation" buttons of the original site, especially since it didn't seem intuitive where they would go.   I have considered adding a "Home" label to the logo space, but I'm not convinced it's necessary.

I personally prefer somewhat lager line spacing, but other people may have
different preference.

The following comments are all minor (maybe just because the pages are
under development):

The directory /FAQ/ has no index.html. I get the file listing if I follow
the "Frequently Asked Questions" link on the top page.
Yeah, I still have most of the generated documentation to do.  I've been focusing on reorganizing the "static" pages.

Except for the top page, the "Zsh Wizard" at the top-right corner of
the page is very small. Is this intentional? Maybe we need him
(the Wizard) only on the top page?
It looked weird to me without something to balance the logo in the header.  And the large version seemed appropriate only on the main page given how much vertical real-estate it takes up. Though when I get the small screen styles written, I will probably hide him on all pages.

If I view the "Documentation" page on my iPhone (or use a narrow Safari
window or larger fonts on macOS) long h2-header like "THE ZSH MANUALS
AND GUIDS" is wrapped because it is limited to 30% of the page width.
Yeah, I'm planning to write a small screen style where the section headers will take up probably the full width of the screen.

On my iPhone, fonts in the "Development" page are smaller than other
pages. I don't know why. This doesn't happen on macOS.
Not sure on that.  I rarely changed font size.  We'll look at it more when I get to the small screen style. Font sizes will change more in those style.

In the dark mode, background of the entire line containing the Zshell
logo in the "News" section is white (maybe Safari only).

Yeah, the original news item just had the transparent black logo, and the extra HTML to choose the dark mode logo seemed like too much HTML for a news item, so I did a white background image of the black logo since that seems to be the "canonical" form, but I could change it.


Also since you tried multiple browsers (some of which I don't have access to) did the alternate list markers show up on all browsers?  I was a little concerned some browsers would have trouble with the expanded "emoji" Unicode.





Messages sorted by: Reverse Date, Date, Thread, Author