Comments (5)
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.
from cdevents.dev.
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.
from cdevents.dev.
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.
from cdevents.dev.
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.
from cdevents.dev.
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.
from cdevents.dev.
Related Issues (19)
- Host schema files under cdevent.dev
- Refresh cdevents.dev look and structure HOT 3
- Add spec version reference to the documentation
- Document desired process for managing publication of spec revisions HOT 14
- Proposed audience strategy for website refresh HOT 3
- Update docsy submodule? HOT 1
- Proposed User Journey
- Future support for translations of site to other languages HOT 2
- Image paths within documentation
- Make the CDEvents meeting link more easy to find
- Document reasons for versioning schema in primer.md
- Add bucket Continuous Operations Events to the list of buckets HOT 1
- Add new release to the website, archive old one HOT 1
- Add logos of adopters, projects and companies, on the website
- Update the project roadmap on the website
- Include architecture diagram in the online docs
- Slack invite link not working HOT 1
- Copy schema links to https://cdevents.dev/0.4.0/schema/ HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from cdevents.dev.