Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Identify target devices / browsers that should be supported for viewing cdevents.dev site #16

Open
tdcox opened this issue Nov 7, 2022 · 5 comments

Comments

@tdcox
Copy link
Contributor

tdcox commented Nov 7, 2022

Consensus is needed on the expected target devices which should be compatible with cdevents.dev

Of particular interest is what expectations are about rendering the spec in a readable form on small devices like phones?

@e-backmark-ericsson
Copy link

Given that one of the main purposes of the site should be to be the storefront for CDEvents, I believe we should strive for a good rendering of the site also on phones. Especially the main page(s). The detailed spec pages are not as important to render as nicely, since they might be more frequently accessed from a laptop browser than from a mobile phone.

@tdcox
Copy link
Contributor Author

tdcox commented Nov 11, 2022

Docsy has some issues on smaller screens, so that may mean we have to do some work on the templating to get it working consistently. The spec is currently readable on a phone, but there is a lot of sideways scrolling needed to navigate the tables.

@afrittoli
Copy link
Contributor

I think it would be great if we could provide better readability on table / phones - at least for main page, general docs pages (browsing audience) and community page.
We can turn tables in a different format if that is more portable.

@e-backmark-ericsson
Copy link

We can turn tables in a different format if that is more portable.

I agree. I'm open for other formats on those tables if that would improve the situation, rather than doing a lot of templating work.
With the differences you describe there @tdcox , it sounds like we'd need to review all docs changes both on a laptop and a phone before merging them. At least if they affect any formatting. I guess that should be documented somewhere in a contributor guide or similar.

@tdcox
Copy link
Contributor Author

tdcox commented Nov 14, 2022

I would suggest that docsy’s current rendering of tables is actually the preferred solution because it keeps the text at a readable size, rather than rescaling the table to fit on the screen, requiring both zooming and scrolling in order to read.

The limitation is in how many words you can fit across a small display at a readable size. We have to be mindful of accessibility here. Too many websites are inaccessible to the over 25s because they use small fonts to gain screen real estate and older people’s eyesight is no longer good enough to resolve them.

I would say that we are close to being at the best available compromise for phone viewing already, unless the whole site was converted to narrative form, which would probably make the desktop experience worse. There are some small tweaks that we can make to the tables to improve rendering but sideways scrolling is always going to be a limitation on phones.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants