search

TEIC / TEI

The Text Encoding Initiative Guidelines
https://www.tei-c.org
Other
273 stars 88 forks source link

Guidelines Redesign #2023

Open hcayless opened 4 years ago

hcayless commented 4 years ago

As @martindholmes remarks in #1984, there are a variety of things in the Guidelines which could usefully be updated to use modern HTML features (and possibly less JavaScript). This ticket is an umbrella for pulling together those issues.

Things I can think of:

  1. Consider using details/summary for showing/hiding TOC information
  2. Back off the super-aggressive use of tables for formatting
  3. Treat specification documentation differently than "back matter" like bibliography (people often go there first)
  4. Improve navigation.
  5. Take a thorough look at accessibility.
martindholmes commented 4 years ago

Given the complex nature of the spec file rendering, I think it would be a good idea to look at the use of CSS grid to get a more responsive design there.

ebeshero commented 4 years ago

Or possibly just CSS flexboxes? I’ve found these a little easier to implement than grid in the wild.

martindholmes commented 4 years ago

Flexbox is easier, I think, but Grid is way more powerful if you can get your head around it. :-)

peterstadler commented 4 years ago

My colleague @sonovice created some nice frontend for the spec pages of an ODD based schema at https://axelberndt.github.io/MPM/docs. This might provide some ideas …