On Friday, 25 December 2015 15:49:21 UTC-5, Daniel Prager wrote: > I've noticed a usability issue with margin notes in the docs: the bolding is > misleading. > > > Example: > > > Regular Expressions in The Racket Guide introduces regular expressions. > > > Problem: The eye is more strongly drawn to The Racket Guide than the relevant > cross-reference. The subliminal message is "if you need assistance click > here". > > > Effect: I (and presumably others) occasionally click on The Racket Guide when > I typically want the more specific reference. This leads to discombobulation.
I've done (seen) this too. Furthermore, it would be nice to find a way to subtly indicate whether one is in the Guide vs Reference: newcomers can take a while to realize/remember that the two exist and which they are in. > > > > > > Suggestion 1: Flip the bolding. > > > Regular Expressions in The Racket Guide introduces regular expressions. > > > > > Suggestion 2: Drop the citation hyperlink altogether. > > > Regular Expressions in The Racket Guide introduces regular expressions. > > > > > > While I think either option would be an improvement, on reflection I'd prefer > #2 because it makes for a simpler and less ambiguous experience. [...] Both look good to me. Perhaps even drop the word "Racket" to make the word "Guide" or "Reference" stand out more. -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
