numberscope / frontscope

Numberscope's front end and user interface: responsible for specifying sequences and defining and displaying visualizers
MIT License
7 stars 14 forks source link

Uniformize graphic design/presentation of Visualizer docs #325

Open gwhitney opened 2 months ago

gwhitney commented 2 months ago

Some Visualizer doc pages have sample images, some still don't, although I think we want them all to. Some float their image, some have it in-line with the description below the image (so sometimes there is almost no description visible until you scroll. And the images come in various different sizes and aspect ratios. We should pick a uniform presentation style and make it easy for visualizer writers to adhere to (with clear instruction in the building a visualizer guide), and convert existing visualizers to the decided-upon style.

gwhitney commented 2 months ago

My personal proposal is to create a sample-image CSS class that we direct visualizer writers to attach to their sample image. Then we use CSS media queries to make this float right at 35% width when the aspect ratio is more than some cutoff, like 0.9, and make it centered non-floating at 35% height (or so) when the aspect ratio is below that cutoff. That way, a decent amount of the description should be available either on desktop or mobile.