[Members] Proposal: Re-Design of the XEP HTML Pages

Dave Cridland dave at cridland.net
Thu Apr 4 08:41:50 UTC 2019


I think this is great, and a vast improvement.

For specifications, I have a strong preference that they are "usefully
readable" without any CSS or Javascript, but you are of course welcome to
use them if you think this makes sense as an enhancement.

With that caveat, I agree with your proposals.

One small niggle - while I like having corporate link colours, is there a
slightly darker orange you could use? It's just a shade or two too light,
and I think for some people this might make it difficult to read due to the
low contrast.

On Wed, 3 Apr 2019 at 17:45, Jonas Schäfer <jonas at wielicki.name> wrote:

> Hey folks,
>
> (Editor Hat on)
>
> For some reason, I was in the mood for writing CSS, and also I was a tad
> unhappy with the mobile rendering of our XEP pages. In addition, I am of
> the
> opinion that they could use a bit of modernizing.
>
> So I went ahead and created a draft of a new design for XEPs. You can take
> a
> look at an example here:
>
> https://sotecware.net/files/noindex/xeptest/xep-0030.html
>
> (All current XEPs are available there, just modify the URL. Note that
> these
> are not official XEP renderings and they may differ from the versions on
> xmpp.org in content for $reasons. Links from those renderings to other
> XEPs go
> to the official documents.)
>
> Summary of changes:
>
> - Completely new CSS based on yaml.de
> - Removed the indent everywhere (-> renders better on small screens)
> - Replaced some parts of XSL magic with HTML/CSS magic (e.g. the TOC
> enumeration)
> - Removed legacy stuff and replaced it with modern stuff
> - Added anchor links to each section, example and table so that you don’t
> have
> to scroll up to link to a specific thing
> - Exchanged the link colour for another colour from the XSF "corporate
> design".
> - Re-organized the header a little
>
> I would love to feedback and stuff you’d like to see in the new design. Of
> course, encouragement to continue this is also highly appreciated ;).
>
> Things I have planned:
>
> - Move the ToC to the left side of the screen so that it stays always
> visible
> if the screen is wide enough for that (should be doable without JavaScript)
> - Add a "Burger Menu" style ToC menu to the top of the screen on small
> screens
> (may require JavaScript)
> - Cleanup of the revision history section (it looks pretty bad at the
> moment)
> - Maybe do something with the footnotes -- ideas welcome
> - Adapt the margins / paddings on small screens (especially code blocks
> and
> examples)
>
> kind regards,
> Jonas
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.jabber.org/pipermail/members/attachments/20190404/7616218e/attachment-0001.html>


More information about the Members mailing list