Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Pierpaolo Bernardi
On Thu, Mar 7, 2013 at 3:36 AM, Eli Barzilay wrote: > They are already indexed, but it happens to be a very popular name so > there are tons of results before it. (Try searching for "stxparam" to > see that it works.) Ooops. You are right. I gave up too soon. _ Racke

Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Eli Barzilay
Four hours ago, Matthias Felleisen wrote: > > I like it. It's up now, at docs.racket-lang.org . 8 hours ago, Robby Findler wrote: > What about moving the google search to the search results page, > saying something like "didn't find what you were looking for? Try a > google-based search." inst

Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Matthias Felleisen
I like it. On Mar 6, 2013, at 11:59 AM, Eli Barzilay wrote: > I have the minimal things that I wanted in a working state now: > > * Links to the PDF versions next to the version. > > * A selection box for different versions of documents. > > * A google custom search. > > All of this is no

Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Pierpaolo Bernardi
On Wed, Mar 6, 2013 at 6:15 PM, Eli Barzilay wrote: > There's no practical way to unify the two searches since they are > implemented in a completely different way all the way to how the end > user interacts with them. Neither Racket's search nor Google's one report the racket/format module, sea

Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Robby Findler
What about moving the google search to the search results page, saying something like "didn't find what you were looking for? Try a google-based search." instead of having two searches next to each other in a somewhat confusing way? (I think someone else made this suggestion; apologies if I missed

Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Eli Barzilay
A few minutes ago, Danny Yoo wrote: > > The other thing that would be nice is if the prior versions of the > docs also included these updates too, but if that can't happen > easily, oh well. Yes -- they all have that. It's just that the previous versions that are generated now are inaccessible..

Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Danny Yoo
On Wed, Mar 6, 2013 at 9:59 AM, Eli Barzilay wrote: > I have the minimal things that I wanted in a working state now: > > * Links to the PDF versions next to the version. > > * A selection box for different versions of documents. > > * A google custom search. > > All of this is now visible on newd

Re: [racket-dev] Tweaked doc pages

2013-03-06 Thread Eli Barzilay
Yesterday, Michael Wilber wrote: > The Google search box seems a bit disorienting to me. Perhaps I just > learned Racket, say yesterday, and it's unclear what it provides > that isn't searched by the search box in the top middle. It might be > nice to integrate that with the results page somehow, l

[racket-dev] Tweaked doc pages

2013-03-06 Thread Eli Barzilay
I have the minimal things that I wanted in a working state now: * Links to the PDF versions next to the version. * A selection box for different versions of documents. * A google custom search. All of this is now visible on newdocs.racket-lang.org, but the older versions go to the right place o

Re: [racket-dev] Tweaked doc pages

2013-03-05 Thread Michael Wilber
The Google search box seems a bit disorienting to me. Perhaps I just learned Racket, say yesterday, and it's unclear what it provides that isn't searched by the search box in the top middle. It might be nice to integrate that with the results page somehow, like a "Didn't find what you're looking fo

Re: [racket-dev] Tweaked doc pages

2013-03-05 Thread Eli Barzilay
Just now, Danny Yoo wrote: > Just wanted to give some more feedback on newdocs; the select box > for getting at the other version of the docs is great! > > Can the version box be moved above the Google search bar or a little > away from it? The issue I ran across is that I start a google > custom

Re: [racket-dev] Tweaked doc pages

2013-03-05 Thread Danny Yoo
Hi Eli, Just wanted to give some more feedback on newdocs; the select box for getting at the other version of the docs is great! Can the version box be moved above the Google search bar or a little away from it? The issue I ran across is that I start a google custom search, and the location of t

Re: [racket-dev] Tweaked doc pages

2013-03-02 Thread Eli Barzilay
OK, so this is an argument to not change the navbar. Meanwhile, having all links jump to an anchor below the navbar seem like a really bad idea to me. So I lean to leaving it as is--? (I'm leaving the newdocs.racket-lang.org with the smaller banner for now, so more people can see if they like/di

Re: [racket-dev] Tweaked doc pages

2013-03-02 Thread Matthias Felleisen
I second this, and I like the smaller banner. On Mar 1, 2013, at 8:25 PM, Robby Findler wrote: > I think we probably shouldn't change the size of the banner here unless we > change it everywhere. > > Robby > > > On Fri, Mar 1, 2013 at 7:12 PM, Eli Barzilay wrote: > Two hours ago, Eli Barz

Re: [racket-dev] Tweaked doc pages

2013-03-01 Thread Robby Findler
I think we probably shouldn't change the size of the banner here unless we change it everywhere. Robby On Fri, Mar 1, 2013 at 7:12 PM, Eli Barzilay wrote: > Two hours ago, Eli Barzilay wrote: > > Two hours ago, Matthew Flatt wrote: > > > The content column is wider than in the normal documenta

Re: [racket-dev] Tweaked doc pages

2013-03-01 Thread Eli Barzilay
Two hours ago, Eli Barzilay wrote: > Two hours ago, Matthew Flatt wrote: > > The content column is wider than in the normal documentation > > display. That makes line-spanning paragraphs a little less nice > > to read, and it makes right-margin notes more likely to fall out > > of the display area

Re: [racket-dev] Tweaked doc pages

2013-03-01 Thread Eli Barzilay
Two hours ago, Matthew Flatt wrote: > At Wed, 27 Feb 2013 11:36:54 -0500, Eli Barzilay wrote: > > > > * The layout should have the main column centered. (I thought that it > > was fine initially if the left column is part of the contents.) > > That column alignment looks good, now. Also, I lik

Re: [racket-dev] Tweaked doc pages

2013-03-01 Thread Robby Findler
On Fri, Mar 1, 2013 at 1:33 PM, Matthew Flatt wrote: > At Wed, 27 Feb 2013 11:36:54 -0500, Eli Barzilay wrote: > > It's now available at newdocs.racket-lang.org. > > > > There are two things that need to be addressed: > > > > * The layout should have the main column centered. (I thought that it

Re: [racket-dev] Tweaked doc pages

2013-03-01 Thread Danny Yoo
>> It's now available at newdocs.racket-lang.org. >> >> There are two things that need to be addressed: >> >> * The layout should have the main column centered. (I thought that it >> was fine initially if the left column is part of the contents.) The docs look good. I'm a little confused at w

Re: [racket-dev] Tweaked doc pages

2013-03-01 Thread Matthew Flatt
At Wed, 27 Feb 2013 11:36:54 -0500, Eli Barzilay wrote: > It's now available at newdocs.racket-lang.org. > > There are two things that need to be addressed: > > * The layout should have the main column centered. (I thought that it > was fine initially if the left column is part of the contents

Re: [racket-dev] Tweaked doc pages

2013-02-27 Thread Eli Barzilay
Just now, Eli Barzilay wrote: > > * The layout should have the main column centered. (I thought that > it was fine initially if the left column is part of the contents.) BTW, resolving this should happen at the CSS level, perhaps just reorganizing them should make it work. But if not, then I

Re: [racket-dev] Tweaked doc pages

2013-02-27 Thread Eli Barzilay
Yesterday, Asumu Takikawa wrote: > On 2013-02-26 09:53:11 -0500, Eli Barzilay wrote: > > I have finally implemented a script that hacks the on-line doc > > pages. Currently, it does the following (and you can see the > > changes on the web now): > > Maybe I'm missing something, but the changes ha

Re: [racket-dev] Tweaked doc pages

2013-02-26 Thread Asumu Takikawa
On 2013-02-26 09:53:11 -0500, Eli Barzilay wrote: > I have finally implemented a script that hacks the on-line doc pages. > Currently, it does the following (and you can see the changes on the > web now): Maybe I'm missing something, but the changes have been rolled back from the main page right?

Re: [racket-dev] Tweaked doc pages

2013-02-26 Thread Matthias Felleisen
Thank you Eli. Thanks for taking the initiative because all pages at racket-lang.org should have the same look and feel. Please roll back the change so that dev can discuss the changes before we commit to them. On Feb 26, 2013, at 9:53 AM, Eli Barzilay wrote: > I have finally implemente

[racket-dev] Tweaked doc pages

2013-02-26 Thread Eli Barzilay
I have finally implemented a script that hacks the on-line doc pages. Currently, it does the following (and you can see the changes on the web now): 1. Slap the contents into a the usual template, so the doc pages finally look like they belong to the site rather than a cheap copy of what you