News for hackers. Stuff that matters.
Re:Sidenotes in Web Design by hennell on Saturday September 23, 2023 @04:32AM (#37621592)
This article would be a lot more persuasive if it's footnotes on mobile weren't a total mess of a system that's going in my bookmarks of bad design.

Everything is in black with white borders so the layers of pop over is hard to distinguish from everything else. The close button is also only at the top which isn't immediately obvious to find when you've read the text and is hard to reach on big mobile screens. (it's also in black with white borders and looks visually more part of the page then the pop over).

It also scrolls the back page to the link, so when you close the article now looks different then it did. At least when a link scrolls down to a footnote then back there's visual indication it did some scrolling. Here the scroll is obscured by the popup so it's very disorienting that it changes when you close the modal. (Again compounded by the fact everything looks the same colour and design)

Conversely the preview links (?) suffer from being too different to each other - the top block on mobile (starting "Sidenotes/margin notes are a typographic convention..." has three links. The first tufte link pops up a decent text that has better typography then this source article. The second tufte link (that uses the same anchor text and looks like it goes to the same place!) shows an identical pop up style with totally different text, now in a tiny size with a screenshot of even tiny text to add to the confusion. Just in case you can squint to read it's all made slightly transparent so you can still read the 4x larger original article text underneath.

There was an article on hacker news a couple of weeks ago where a guy was looking into the history of the Bloomfield bridge. I commented then that that article had some wonderful "footnotes", they just expanded inline you could read or not the extra info very easily. This is just an ugly and frustrating experience and certainly not anything that instills me with confidence in their articles advice.

Re:Sidenotes in Web Design by canadiantim on Saturday September 23, 2023 @06:16AM (#37621963)
I did some sleuthing to look into the footnotes implementation done by that guy looking into history of the Bloomfield bridge. Here it is for anyone else who’s interested as well: https://www.stevans.org/inline-footnotes/
Re:Sidenotes in Web Design by extra88 on Saturday September 23, 2023 @09:47AM (#37623176)
Like pretty much all CSS interactivity hacks, those footnotes are not accessible; you can't operate them with a keyboard and screen readers only read the footnote number as a part of the text (even if the screen reader user guesses it's meant to be interactive, they can't click it).
Re:Sidenotes in Web Design by rijoja on Saturday September 23, 2023 @11:50AM (#37624345)
What's the best way to handle footnotes, from a accessibility point of view?
Re:Sidenotes in Web Design by extra88 on Saturday September 23, 2023 @02:09PM (#37625777)
I don't know of a better option than what a number of blogs, like Daring Fireball [0] do, link the footnote number to to the footnote, end each footnote with a link back to the footnote number (typically using the ↩ character).

Kitty Giraudel wrote about a version that's a bit "extra." [1] They make a whole word or phrase the footnote link text but style automatically inserted CSS counters so only numbers have the appearance of a link. Plus, each link has a description, "Footnote," to make it more clear to screen reader users where it goes.

[0] https://daringfireball.net/2023/08/whats_the_deal_with_senso...

[1] https://www.sitepoint.com/accessible-footnotes-css/

Re:Sidenotes in Web Design by rijoja on Sunday September 24, 2023 @06:04AM (#37631691)
Interesting, thank you very much!
Re:Sidenotes in Web Design by rijoja on Saturday September 23, 2023 @11:22AM (#37624074)
If an "ad hominem" is what you call it when someone criticizes a person instead of their argument, what do you call it when you criticize someone's webpage instead of it's content?

I don't think the author's goal here is to persuade anybody of anything, but rather to inform people of design options, which I am very grateful for.

Personally I also find the website to have a fantastic design, and that a source of inspiration in terms of design.

Re:Sidenotes in Web Design by threatofrain on Saturday September 23, 2023 @12:40PM (#37624875)
I think both sides simultaneously have a leg to stand on. In terms of self-conduct, I try to skip past the noise and go for what I think is informative, and if complaining about a dentist's teeth is not informative then I skip past it.

At the same time I understand there is an unshakeable part of how human judgment works that cannot help but develop a story on why the dentist has bad teeth, and thus it is an informal burden on the proponent of something to also be an exemplar of what they say.

Re:Sidenotes in Web Design by rijoja on Sunday September 24, 2023 @05:59AM (#37631656)
That's a really good point, and I agree with you fully. What I do not agree with and am not sure if you agree with either, is that the dentist has bad teeth to begin with. Furthermore if you where to say that 1+1=2, isn't in fact 2 because a dentist with bad teeth said it was then you are simply plain wrong.

Personally I find gwern to produce exemplary content*, and on a page that is really well designed. Which very much might be a matter of taste obviously, but this is very much the type of taste that makes me visit HN frequently, both in terms of aesthetics and content.

I would highly recommend anyone reading this, to have a look at the rest of the content on gwern's webpage.

Re:Sidenotes in Web Design by threatofrain on Sunday September 24, 2023 @12:00PM (#37634253)
Personally I find Gwern's design so inspirational that it doesn't matter if it's bad or good anymore. I think there is some kind of issue with execution because on my computer the website has layout-shifting problems, but it doesn't matter for me because inspiration is rare.
Re:Sidenotes in Web Design by brigandish on Monday September 25, 2023 @08:50AM (#37642907)
Argument ad paginum (paginum being page) or perhaps argument ad opus (opus being work or labour) ?
Re:Sidenotes in Web Design by rijoja on Tuesday September 26, 2023 @11:22AM (#37660692)
Ah didn't expect an answer to that, but thank you, that is very interesting!
Re:Sidenotes in Web Design by gwern on Saturday September 23, 2023 @05:06PM (#37627557)
(I am the website author & tech co-creator with Said Achmiz.)

> Everything is in black with white borders so the layers of pop over is hard to distinguish from everything else.

They have double-white borders and drop shadows. It looks reasonably distinguished to me, but I suppose we could try one of the very light grays to see if that helps.

> The close button is also only at the top which isn't immediately obvious to find when you've read the text and is hard to reach on big mobile screens.

...Where else would the 'X' close button be?

> it's also in black with white borders and looks visually more part of the page then the pop over

The 'X' is right next to the title, it definitely does not look like it's 'more part of the page than the pop over'.

> It also scrolls the back page to the link, so when you close the article now looks different then it did.

If it didn't do that, then the anchor & context for the pop-over wouldn't be visible or the pop-over would have to be absurdly small whenever the tapped-link wasn't at the top of the screen already. So the shifting-to-top is good.

I think you're right that it should restore the position. It was originally a pop-in, so that didn't come up before we recently swapped to pop-over.

> that uses the same anchor text and looks like it goes to the same place!

I'll modify the text to be clearer.

> now in a tiny size with a screenshot of even tiny text to add to the confusion. Just in case you can squint to read it's all made slightly transparent so you can still read the 4x larger original article text underneath.

That is not how it's supposed to look, and doesn't on other pages - just here. Amusingly, it's caused by an interaction between the .sidenote class, and the page URL being 'sidenote'. (Nor is this the first time! JS and web browsers, man.) If you had tried it on any other page, like the section links of the abstract in my most recent page, https://gwern.net/suzanne-delage , it would've been fine. We've pushed a fix.

> I commented then that that article had some wonderful "footnotes", they just expanded inline you could read or not the extra info very easily.

It's a good essay (https://tylervigen.com/the-mystery-of-the-bloomfield-bridge) but the footnotes are not the highlight of that page.

- The zebra-stripe blockquote styling is annoying and makes them hard to read with visual moire (but can be fixed). - The fact that you have to opt into them with no indication of whether they are worth reading means cognitive burden (and while some are quite lengthy and worth reading, many are not). The author alleviates this a bit by sometimes specifying 'long note', but that increases the authoring burden, and doesn't solve the problem much (short notes can be interesting too). - 'Note' for each anchor is verbose & repetitive. - The footnotes are not aggregated at the end, so you can't skim or check them en masse. (And did you think you could just read or search the HTML source? Not without additional processing or word-wrap options to fix the ultra-long lines.) - The lack of a real hover popup is made up for with the hack of using tooltips - an idea I tried and abandoned very early on, because it strips formatting & cannot be made interactive or accessible; in his case, his tooltips are actually worse than useless because they silently, without indication, strip out large parts. For example, one tooltip at least bails out and tells you to click on it to see the email he sent, so at least you know you're losing everything, but then a later one ("The feds would pay up to 90% of the costs") silently drops an entire chunk! - The tooltips + default collapse also means that they aren't searchable: C-f 'pro-rata' will turn up nothing, because it's hidden in a footnote. (This is solved by aggregating or display by default; if one chooses not to do that, one should do something - for example, detect the search event, uncollapse all of them to make them visible for search, and then recollapse.)

I can't fault it on some issues like mobile handling or multiple+large footnote handling, but that's only because it avoids the problem of desktop sidenotes entirely, and is just the mobile version. (Which is why I didn't bother to link it: it doesn't do anything better than the examples already on the page, although now that I've looked closer, it may be worth linking as an example of the problems with trying to stuff footnotes or annotations into tooltips.) You like it because you don't want desktop footnotes at all, apparently, not because it represents a good solution.

Re:Sidenotes in Web Design by ttepasse on Sunday September 24, 2023 @01:54AM (#37630483)
> (I am the website author & tech co-creator with Said Achmiz.)

I recently spend some time reading some parts of your website and found myself a little bit frustrated by the experience. I'm hesitant to criticise, since your site is of course your personal Memex, but count me as a n+1 with the opinion that there is room for improvement.

I too struggled with the hover popups. The boxy design isn’t very aesthetically pleasing – at the same time too much chrome, I think, and like the OP wrote, too less differentiation from the body of the page. For a casual reader the whole window management of those popups seems too much. And there is a certain lack of predicability of them. For one, only some links seem to have them, second, the delay to pop is just the right time of infuriating. A common occurrence of mine, when reading your pages, is the following: I'm scrolling down, start reading the next paragraph, then, without me doing something, suddenly a popup pops up. What did I do? Did I do something wrong? Why is that happening? Of course, the explanation is simple: while scrolling, my cursor landed on a link which has a link preview popup and the delay happens, presumably, because the network request fetched the preview. But it is still an UI change without any real and conscious user action on my part. The effect is that one has to be careful to read you page, knowing where one's cursor is, and where to put it as not to trigger anything. I ended up deactivating the popups and later using Reader mode, first your site's own, then later my own browser's.

(Aside: The gear icon in the top right seems invisible in my browser [Safari, MacOS]. There is still a clickable spot of white background, the rest of the menu works. I only found out that there is a setting because I was reading your site design pages, learned about that feature and compared with Chrome.)

I am, sorry to say, also not the biggest fan of the design. The main body imitates in a lot of ways a classical printed product. That, I think, is great. But the specialised parts – the examples, the backlinks, the digressions, the blockquotes, even the inline <code> fragments – are all in that boxy sub-design, sometimes even in boxes inside of boxes, which, I think, clashes with the book aesthetic. A common cited quote by designers is Design is perfect when there is nothing more to take away. In that vein I'd try to use far less boxes but more typography and whitespace for differentiation.

And: I'd use far less interactivity. Maybe that's just me, but my preferred interaction with web pages is simply scrolling, not clicking. That is both on Desktop (space bar) and on touch. Click to expand something, click to turn a carousel, etc. is always a touch annoying. My preferred textual web page is simply static, has no reflows, and has no other need for interaction other than scrolling down.

All of these changes are of course not necessary – there are far worse pages on the web. But maybe, if you sometimes in the future have time, interest and energy, you'll keep iterating. gwern.net has very good bones; but there is room for improvement.

Oh, and since this thread is about sidenotes: When I, in a default HD desktop viewport resolution put the zoom level up a notch, because I find the font size too small, the sidenote implementation decides that the sidenotes have less room and the sidenotes are gone. I can understand that at higher zoom levels, but at a simple 110% it's frustrating. Stuff like that is why me preferred sidenote implementations are a simple float:right with the notes displayed inline at a break point for smaller viewports.

Re:Sidenotes in Web Design by gwern on Tuesday September 26, 2023 @05:01PM (#37665764)
> The gear icon in the top right seems invisible in my Safari browser

Fixed. Since Safari is the worst browser, you will not be surprised to hear that this is not even the first problem we've had with the gear icon being invisible or disappearing in Safari...

> put the zoom level up a notch, because I find the font size too small

I'd like to increase the font a touch more, but Achmiz says that going a bit bigger is not doable due to fractional sizes and rounding; we'd have to go substantially larger, and that is too large for my tastes.

> I can understand that at higher zoom levels, but at a simple 110% it's frustrating.

This is an argument I've had with Achmiz several times. I feel that there's enough margin to work with at the current breakpoints that you could stuff sidenotes into them and show them to substantially more readers than we do now; he insists that no, there is not, when all is said & done, enough pixels left over to provide adequate, readable, appropriately-margined sidenotes and the breakpoint can't be lowered.

> For one, only some links seem to have them

Yes. You'll appreciate that it's not feasible to put full annotations on every link, or even provide snapshots to popup. So that's why links are marked up with either dotted underlines or pipe prefixes. The markers can't be any more obtrusive because they need to be on most links, and there is no available visual iconography to draw on which might be 'intuitive'. The reader just has to learn what those mean.

(I've been monitoring AI summarization work because with cutting-edge NNs, it may finally be feasible to summarize every link and drop the need for markup - the reader can just assume that there is an annotation to popup if they're interested. Maybe next year.)

> I'm scrolling down, start reading the next paragraph, then, without me doing something, suddenly a popup pops up.

We find this kinda weird because this is just not an issue for us. My mouse fades out when not used, because why would I want it around? Or it's positioned in a reasonable place. The idea that people just leave their mouses in place and scroll without ever interacting with the popups is... untidy.

Anyway, you're not the first person to mention that, and it's not as crazy a workflow as the people who say they highlight large chunks of the screen compulsively (sometimes admittedly for no reason at all, just sorta to fidget?), so this is as good a time as any to address it. After some discussion, we think that the right thing to do here would be to: 1. disable all hover events (uncollapses included) on a scroll event; then 2. re-enable hover on each mouse. This should avoid any interactive triggers while simply scrolling, and re-enable interaction the moment the reader actually tries to do something the natural way. It avoids the overhead of requiring explicit clicks or issues with storing position/velocity like the alternative 'motion intent' approach (which seems like a fair amount of compute), while being simple & robust to any glitches in browser events (unconditionally setting or resetting a single boolean).

> The boxy design isn’t very aesthetically pleasing...The main body imitates in a lot of ways a classical printed product. That, I think, is great. But the specialised parts – the examples, the backlinks, the digressions, the blockquotes, even the inline <code> fragments – are all in that boxy sub-design,

I like it. It's a fusion of technical writing & Art Deco-esque sensibilities, which I think reflects my website's broad two-cultures portfolio.

> In that vein I'd try to use far less boxes but more typography and whitespace for differentiation.

'Use less' is the sort of advice that is hard to debate without specifics like mockups, because from my perspective, I've already tried to rip away as much as I can, and ripping away more either renders things ambiguous in the way you are complaining about for the popovers or will be lossy in terms of semantics. (Even the apparently purely-decorative touches are actually semantically meaningful: the dropcaps, for example, might appear to be purely a book-style flourish, but actually tell you which of the 5 categories of articles you are currently reading.)

Re:Sidenotes in Web Design by gwern on Friday September 29, 2023 @01:13PM (#37707241)
The popovers should now jump back to the original position so you don't get that shift effect. And we've also made the background dim/more opaque (perhaps too much) so that it's extremely clear what is the popover and what is the original page.
Re:Sidenotes in Web Design by gwern on Monday October 02, 2023 @07:25PM (#37745836)
Popups will no longer fire when you scroll.