Re: [racket-users] minor proposed update to docs typography

2017-11-21 Thread Robby Findler
On Tue, Nov 21, 2017 at 9:44 AM, Matthew Butterick  wrote:
>
> On Nov 21, 2017, at 3:32 AM, Robby Findler 
> wrote:
>
> That may have been done that way to make the docs.racket-lang.org page look
> better (to draw your eye to the right manual).
>
>
> I figured.
>
> But hard-coding formatting inside `title` is a blunt instrument. It's not
> restricted to the TOC, but instead manifests globally. And, because it's
> implemented with "font-weight: bold" and not a CSS class, it's difficult to
> manipulate from outside (unless you employ the Hendershott Method)
>
> Forbidding `title` formatting entirely is not the answer. For instance, "How
> to Design Programs Teachpacks" should rightly have non-negotiable italics;
> "raco: Racket Command-Line Tools" should have non-negotiable code formatting
> for `raco`. In those cases, formatting is intrinsic to the meaning.
>
> But bold has no semantic purpose — it's just an emphasizer. And there are
> better ways to emphasize things in the TOC (e.g., page position, whitespace)

Absolutely. Feel free to change it.

Robby

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-21 Thread Greg Hendershott
> restricted to the TOC, but instead manifests globally. And, because it's
> implemented with "font-weight: bold" and not a CSS class, it's difficult to
> manipulate from outside (unless you employ the Hendershott Method)

I object to using that name for such a weak hack.

The full Hendershott Method also involves overriding !important with
!!important as well as parsing HTML using regular expressions.

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-21 Thread Matthew Butterick

> On Nov 21, 2017, at 3:32 AM, Robby Findler  
> wrote:
> 
> That may have been done that way to make the docs.racket-lang.org 
>  page look better (to draw your eye to the 
> right manual).

I figured. 

But hard-coding formatting inside `title` is a blunt instrument. It's not 
restricted to the TOC, but instead manifests globally. And, because it's 
implemented with "font-weight: bold" and not a CSS class, it's difficult to 
manipulate from outside (unless you employ the Hendershott Method)

Forbidding `title` formatting entirely is not the answer. For instance, "How to 
Design Programs Teachpacks" should rightly have non-negotiable italics; "raco: 
Racket Command-Line Tools" should have non-negotiable code formatting for 
`raco`. In those cases, formatting is intrinsic to the meaning.

But bold has no semantic purpose — it's just an emphasizer. And there are 
better ways to emphasize things in the TOC (e.g., page position, whitespace)

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-21 Thread Robby Findler
On Mon, Nov 20, 2017 at 11:25 PM Matthew Butterick  wrote:

>
> On Nov 20, 2017, at 6:10 PM, Greg Hendershott 
> wrote:
>
>
>
> The following example hack _seems_ to clear the "impervious" hurdle?
>
>  a.Sq span { font-weight: normal !important}
>
> I'm not a CSS guru. This barely clears the "it works" hurdle.
> That is, I don't know if the "Sq" class is reliable as a parent
> selector. Also this doesn't bold the other link (but at least now
> they're equally non-bold).
>
>
>
> I saw the best minds of my generation destroyed by CSS, starving
> hysterical naked ...
>
>
> (PS I think the solution is just to forbid `bold` inside a `title` [1]
> because it confounds two issues best left separate)
>
>
> [1]
> https://github.com/racket/racket/blob/master/pkgs/racket-doc/scribblings/guide/guide.scrbl#L4
>

That may have been done that way to make the docs.racket-lang.org page look
better (to draw your eye to the right manual).

Robby


> --
> 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.
>

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-20 Thread Matthew Butterick

> On Nov 20, 2017, at 6:10 PM, Greg Hendershott  
> wrote:
>>> 
>> 
>> The following example hack _seems_ to clear the "impervious" hurdle?
>> 
>>  a.Sq span { font-weight: normal !important}
>> 
>> I'm not a CSS guru. This barely clears the "it works" hurdle.
>> That is, I don't know if the "Sq" class is reliable as a parent
>> selector. Also this doesn't bold the other link (but at least now
>> they're equally non-bold).


I saw the best minds of my generation destroyed by CSS, starving hysterical 
naked ...


(PS I think the solution is just to forbid `bold` inside a `title` [1] because 
it confounds two issues best left separate)


[1] 
https://github.com/racket/racket/blob/master/pkgs/racket-doc/scribblings/guide/guide.scrbl#L4
 


-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-20 Thread Greg Hendershott
p.s. I meant to add: I love your original redesign and this makes it
even better.

On Mon, Nov 20, 2017 at 9:09 PM, Greg Hendershott
 wrote:
>>> It looks very nice, but as a side effect slightly exacerbates a
>>> long-standing ergonomic issue with cross-links in the side-notes:
>
> Like Daniel mentioned, I click the bold one by mistake. A lot.
>
>> I agree, but in that case the bold styling is attached to "The Racket
>> Reference" within the HTML markup, so AFAICT it is impervious to any CSS
>> override.
>
> The following example hack _seems_ to clear the "impervious" hurdle?
>
>   a.Sq span { font-weight: normal !important}
>
> I'm not a CSS guru. This barely clears the "it works" hurdle.
> That is, I don't know if the "Sq" class is reliable as a parent
> selector. Also this doesn't bold the other link (but at least now
> they're equally non-bold).

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-20 Thread Greg Hendershott
>> It looks very nice, but as a side effect slightly exacerbates a
>> long-standing ergonomic issue with cross-links in the side-notes:

Like Daniel mentioned, I click the bold one by mistake. A lot.

> I agree, but in that case the bold styling is attached to "The Racket
> Reference" within the HTML markup, so AFAICT it is impervious to any CSS
> override.

The following example hack _seems_ to clear the "impervious" hurdle?

  a.Sq span { font-weight: normal !important}

I'm not a CSS guru. This barely clears the "it works" hurdle.
That is, I don't know if the "Sq" class is reliable as a parent
selector. Also this doesn't bold the other link (but at least now
they're equally non-bold).

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-20 Thread Matthew Butterick
On Monday, November 20, 2017 at 7:59:40 AM UTC-8, Jens Axel Søgaard wrote:
>
> IPad Pro small landscape chrome. 
>

Thanks, the iOS display problem is now fixed. 



On Monday, November 20, 2017 at 11:10:41 AM UTC-8, Daniel Prager wrote:
>
> Hi Matthew
>
> It looks very nice, but as a side effect slightly exacerbates a 
> long-standing ergonomic issue with cross-links in the side-notes:
>


I agree, but in that case the bold styling is attached to "The Racket 
Reference" within the HTML markup, so AFAICT it is impervious to any CSS 
override.

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-20 Thread Daniel Prager
Hi Matthew

It looks very nice, but as a side effect slightly exacerbates a
long-standing ergonomic issue with cross-links in the side-notes:

docs.racket-lang.org:

revision:

In almost every case the user will want to click on the unbolded specific
link *(Pattern Matching*), but the bolding entices the user to click on the
generic link (*The Racket Reference*).
​
Suggestion: remove and de-emphasise the distracting hyperlink ...

Pattern Matching
 in *The
Racket *
*Reference* provides more on
pattern matching.


Dan

-- 
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.


Re: [racket-users] minor proposed update to docs typography

2017-11-20 Thread Jay McCarthy
It all looks beautimous to me!

On Sun, Nov 19, 2017 at 11:13 PM, Matthew Butterick  wrote:
> http://mbutterick.github.io/racket-doc-redo/doc/
>
> This link demos some small typographic updates to the docs:
>
> + new title font (that matches the one used on other Racket websites)
> + new monospaced font (that matches the subhead font)
> + some technical tweaks to the body font to make Windows rendering better
> + 20% smaller font download
>
> If something looks wrong, I welcome bug reports. But here's the kind of bug
> report most likely to move me to action: email me* a screen shot of the
> problem page, and also a comparable page on docs.racket-lang.org so I
> understand how they both look on YOUR machine.
>
> In the past, people have liked to send me novelistic reports like "well MB,
> if you look at the docs on a Google Antitrustbook Mini running Debian
> Ultraluxe 2014 with the Squealing MocoLoco browser ..." At which point I
> slide out of my chair, unconscious. All I need are the screenshots. Really.
> Thank you.
>
> PS Or make a GH issue
>
> https://github.com/mbutterick/racket-doc-redo/issues
>
> --
> 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.



-- 
-=[ Jay McCarthy   http://jeapostrophe.github.io]=-
-=[ Associate ProfessorPLT @ CS @ UMass Lowell ]=-
-=[ Moses 1:33: And worlds without number have I created; ]=-

-- 
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.