Re: Feedback on prototype reorganized Zsh website

[Oliver Kiddle <opk@xxxxxxx>]

On 23 Oct, Clinton Bunch wrote:
> It's using Jinja templates to generate the static pages and storing 
> release, mirrors, and news as JSON files so they only have to be updated 
> in one place.  The plan is to write more code to manage these JSON files.

Given that we include release information in the source distribution,
that would still need to be updated in two places. For the source
distribution, we need something rather more amenable to being viewed in
a terminal with less or even cat - so plain text or perhaps markdown. Is
your intention that we treat the JSON files as the primary and generate
either plain text or markdown from the JSON?

As I mentioned before but never got around to writing a patch for, I
think we should restructure the release notes in the source distribution
in a manner similar to that used by the git project: individual files
named by version number in a RelNotes directory and the top-level NEWS
file being a symlink to the file for the latest release (except where
it is still an unnumbered work-in-progress release). The current split
between NEWS and README is not ideal.

The approach of using Jinja sounds fine to me. Apart from the JSON files
you mention, are you using Jinja directly within HTML?

The site looks great to me. With regard to the fonts, I wonder whether
it would be more consistent if we matched the font used in the Zsh logo
although that was somewhat custom. Including font files does increase
the size somewhat. The wizard can be shrunk by about 10% with zopflipng.

Finally, thanks for working on this.

Oliver