squash the entire development of the new web page into a small number of commits to help rebasing

Author: mfelleisen

README.md

@@ -27,6 +27,24 @@ To build:
 
  [See "upload" and `--dry-run` for an alternative]
 
+* The simplest way to build the whole site is with 
+
+  racket -l- racket-lang-org/sync --save-temps --render-locally Web ; open Web/www/index.html
+
+  This renders the site in some temp directory and then moves the directory
+  to 'Web` here. It will also open the front-page index file in your
+  default browser on the Mac.
+
+* `pollen` problems 
+
+  `pollen` occasionally fails with really strange "deep in the guts"
+  error messages. `pollen` changes and doesn't work right with its old
+  files. After double-checking that you have everything in a new
+  commit, does **DANGER!** `git clean -d -x -f`. 
+
+  **DANGER!** Really make sure that you don't have any files you want
+  to keep that aren't committed! This command also rm's uncommitted files. 
+
 * Run "racket all.rkt -o <dir>" to build all pages to subdirectories of
   <dir>. As a safety measure, the target directory must not overlap
   with any installed directory. (Use `-f' in scripts to avoid

feedback-from-dev.md

@@ -0,0 +1,157 @@
+## Arrangement/Content 
+
+- "With a Vibrant Community" could be just "Vibrant Community".
+
+- "Strong" is kind of a strange word to describe safety and reasoning
+  features. Why not "safe"? I don't like that either, but I think it's
+  better.
+
+  Use  "Robust" 
+
+- If I could change one thing, I would edit the first paragraph of the “Any
+  Syntax” section.  Instead of “Real Racket programmers love parentheses”,
+
+Real 
+
+  maybe something like “Racket programmers usually love parentheses”, and
+  instead of “is almost as easy as building beautiful languages”, perhaps
+  “is almost as easy as building parenthesized languages”.
+
+?? 
+
+- ? For "Little Macros", can we have a different example? It takes me more
+  than a minute to figure out what's going on in that example, even though
+  I think I know macros and Racket syntax at some level. People who are new
+  to Racket are going to just skip that example with confusion. 
+
+```
+#lang racket
+
+(require syntax/parse/define)
+
+(define-simple-macro (where* ((~literal define) h b) clauses)
+  (define h (let () (begin . clauses) b)))
+
+(where* (define is-5-odd (odd? 5))
+        [(define (odd? n) (if (= n 1) #t (even? (- n 1))))
+         (define (even? n) (if (= n 0) #t (odd? (- n 1))))])
+
+(if is-5-odd "five is odd" "five is not odd")
+```
+
+## Mechanics 
+
+- add tabs to browser HISTORY  (pushState)
+
+## Code Examples 
+
+- in initial web page, message-box
+
+- Gettybsburg's address with @As-scores[87]
+
+## Looks 
+
+- screen size problems (MF yes someone should figure this out) 
+
+  fixed by Robby and Jesse 
+
+- Can we make the headers ("Racket, the Language-Oriented Programming
+  Language", "Racket, the Ecosystem") change color on hovering to indicate
+  that it can be clicked? 
+
+- Robby: "Sierpinski" plus 2htdp/image code 
+
+- Robby: It would be easier on the eyes if the text color was slightly darker blue
+
+## Probably Useless 
+
+
+## No 
+
+- There should probably be a description of what language oriented programming is.
+- "little macros" and "big macros" should be adjacent.
+- "general purpose" and "DSLs" should be adjacent. 
+- ? It would be cool if the typed Racket example contains a type error, and
+  we show how typed Racket catches the error. 
+
+
+- When trying to get the #lang examples to display again after clicking a tab
+  under "the language-oriented programming language" section, my instinct was to
+  click some of the whitespace off to the side to "deselect" the current tab.
+  This did not work, and I had to instead click on the section heading.
+
+- The very first thing I see is news. If I'm a regular Racket user I would
+  know where to get news from. If I'm a new user, I wouldn't care about
+  news. Either way, I think it should have a place in homepage but not at
+  the top.
+
+- ... trying to get all 3 ideas into view without scrolling (MF: remove news
+  and get there?) 
+
+- What's the difference between `new frame%`, `message-box`, and
+  `make-object button%`.   ("Why aren't they `frame`, `message-box`, and
+  `button`?"). 
+
+- A Scribble example could be more free text, with only one or two `@(`.
+  It would be nice if the Scribble example is mainly proses. Otherwise,
+  users could (for example) assume that this is yet another Racket program
+  will a nice string literal syntax.
+
+- Maybe leave out the comments in the code samples ... try to read the code and guess what it does
+
+- don't use JS for tabs (MF: I don't even know what this means)
+
+- The big blue headings look like another header, they are more prominent than the main top page header, which looks weird
+
+- The giant racket logo next to the code looks misplaced, the racket logo is already in the top left.
+
+- why isn't there a publications page? 
+
+- show output of programs? -- For "General Purpose", again, users want to
+  see an output. A GUI window (like the "Big Macros" example) would
+  suffice. 
+
+- The JavaScript driving a change of "tabs" doesn't use the history APIs
+  (e.g. history.pushState, window.onpopstate), so it doesn't work as (I)
+  expected with browser-based control operators like "back" and "duplicate
+  tab." Mumble about our web server and continuations 
+
+
+- Regarding the second row again, I think that we should not expect users
+  to click on those tabs to explore. Instead it should be presented
+  statically, maybe as grid of little boxes. Web pages are much more
+  pleasant when I could just scroll through it.
+
+### Greg's Response 
+
+Many good ideas here!  A couple suggestions:
+
+1. I recommend not assuming screen sizes.
+
+Right-click, choose Inspect Element, and click the little mobile icon.
+Try various sizes, from a little mobile phone on up to an iPad. (This
+sort of tool is available in Firefox and Chrome.)
+
+The current experience is not good. It should be: Someone might be on a
+train or plane, following a link from social media or the orange site.
+Sometimes commuting or traveling is their main opportunity to learn
+about new things and form first impressions.
+
+
+2. I recommend not using JavaScript to implement "tabs".
+
+This isn't a "single page web app". It is text and images. It could
+simply flow through whatever size screen is available, small, medium, or
+large. Let the web browser do its job. (And let the page download
+faster, probably get higher search rank, etc.)
+
+
+TL;DR: The current tabby thing is not helping on small screens; on large
+screens it is (in my opinion) a frustrating Advent calendar. 
+
+## Future Work 
+
+- The code snippets, e.g. under "little macros", are in too small of a font to
+  read. Reminds me of talks where they just display tons of code to bamboozle
+  the audience, which always annoys me.
+

feedback-sam.txt

@@ -0,0 +1,101 @@
+
+DISAGREE, NOT WILLING TO DISCUSS 
+
+  - I prefer the line-separator style to the gray/white background style for the lower boxes.
+  - would moving [the slogan] to the top be better?
+
+DISAGREE, WILLING TO DISCUSS 
+
+  - I don't think the text in the new top box is very helpful. What is a
+    "real problem"? And hopefully, for most people their problems are
+    well-solved in an _existing_ Racket language -- writing a new language
+    is not a first-day Racket program.  The "Got ..." phrasing feels off to
+    me as well.  The slogan on the current home page is more compelling
+
+I am willing to brainstorm. 
+
+   - I like combining boxes as you did, and getting rid of the
+     Scheme/Lisp one. However, I think some of the links that went away
+     would be good to keep: the documentation, the repository, the style
+     guide, for example. I'm not sure what the best place to put them would
+     be -- maybe a new box that's a "quick start" box?
+
+ It is really hard to bring across that our documentation is special and
+ how special Scribble is in the chosen format. I am okay with the format
+ mostly. Is the Style guide special?  The repo has a button at the top.
+
+ I could add a pair of boxes? 
+
+  - I miss the examples of languages. A language home page without any
+    programs seems like a mistake to me, and our programs should show off
+    the language-oriented nature of Racket.
+
+The Julia language page comes w/o sample programs on the home page. 
+I think that's fine. But I am willing to listen to counter-arguments.
+
+DON'T KNOW HOW TO DO
+
+  - If the text is now there the whole time, I think the links should be
+    clickable all the time.
+
+  - I think the IDE box now says too little about docs and too much
+    about details (like the Vim mode).
+
+  - Many of the languages listed on the "Languages" page (in the intro
+    paragraphs) could be hyperlinks, as could the link to the
+    documentation.
+
+  - I think the new "Languages" page is too single-column. Could we put
+    some of these boxes next to each other horizontally (as on the home
+    page)? 
+
+The new Languages page isn't mine. Someone contributed it as a PR, and I
+pulled it in. But yes, I think we can modify it anyway but for now I'll
+leave it alone. I'd like to discuss it first.
+
+DON'T UNDERSTAND 
+
+   - The new boxes on the front page don't all seem to line up.
+I think I fixed this. 
+
+  - I like moving to having the text on the page initially.
+  - If we aren't showing them in detail, I don't know that the fractals
+    make things better. It mostly seems to make things harder to read
+    right now.
+I know how to remove the links, but I kind of like the background. 
+
+DONE, I THINK 
+
+
+  - The new "sample languages" page has some visual issues -- text is
+    cut off below the language snippets.
+
+Done. 
+
+  - If there's now a Donate button on the top line, should that be in the
+    other places on the web page where those three boxes appeared before?
+
+Pollen doesn't seem to allow abstraction, so I made these pages look
+alike manually. All of them list four buttons now at the top: 
+download, docs, packages, donate. 
+
+I could not figure out how to add these buttons to blog, download, and
+snapshots. Sadly, they are written in Racket, so I should have been able to
+figure out something :) ~~~ But having said this, I am not sure that these
+pages should look like the front page. ~~~ We already have many page
+styles.
+
+DONE, SOMEWHAT 
+
+   - I think the claims made for Typed Racket are too strong. My
+     suggestion would be to combine the Contracts and Types boxes into one,
+     and not say things like "done right".
+
+You're right. The "done right" was over the top. But at the same time, we
+are the only ones who support full-fledged soundness in the old sense and
+"soundness and completeness" in the new one.
+
+So I compromised a bit and changed the title for "Typed" and some of the
+prose in both. I also disagree with the idea of combining the two. They are
+separate ideas, and Racket supports each in the cleanest way of any
+language around. We should proudly advertise both.

info.rkt

@@ -2,28 +2,34 @@
 
 (define collection "racket-lang-org")
 
-(define deps '("graph"
-               "gui-lib"
-               "base"
-               ("plt-web-lib" #:version "1.3")
-               "at-exp-lib"
-               "net-lib"
-               "racket-index"
-               ("scribble-lib" #:version "1.28")
-               "syntax-color-lib"
-               "plot-gui-lib"
-               "plot-lib"
-               "math-lib"
-               "pollen"
-               "css-tools"
-               "sugar"
-               "txexpr"
-               "gregor-lib"
-               "frog"
-               "rackunit-lib"
-               "pict-lib"
-               "draw-lib"
-               ("s3-sync" #:version "1.10")))
+(define deps
+  '("slideshow-lib"
+     "csv-reading"
+     "typed-racket-lib"
+     "datalog"
+     "graph"
+     "gui-lib"
+     "base"
+     ("plt-web-lib" #:version "1.3")
+     "at-exp-lib"
+     "net-lib"
+     "racket-index"
+     ("scribble-lib" #:version "1.28")
+     "syntax-color-lib"
+     "plot-gui-lib"
+     "plot-lib"
+     "math-lib"
+     "pollen"
+     "css-tools"
+     "sugar"
+     "txexpr"
+     "gregor-lib"
+     "frog"
+     "rackunit-lib"
+     "pict-lib"
+     "ppict"
+     "draw-lib"
+     ("s3-sync" #:version "1.10")))
 
 (define pkg-desc "Sources for http://racket-lang.org")
 

school/2019/index.html.pm

@@ -19,6 +19,7 @@
 ◊h2{◊xlink{Schedule}}
 ◊h2{◊xlink{Accommodation}}
 ◊h2{◊xlink{Tickets}}
+◊h2{◊xlink{Housing}}
 ◊h2{◊xlink["previous"]{Previous Racket Schools}}
 
 ◊h3{◊xtarget["overview"]{Domain-Specific Languages from Racket}}
@@ -57,11 +58,11 @@ This track will be taught by ◊link["https://www.ccs.neu.edu/home/matthias/"]{M
 
 ◊ul[
 
-◊li{academic researchers at all levels who wish to understand LOP research,}
+◊li{academic researchers who wish to understand LOP research,}
 
 ◊li{professionals who wish to learn in depth how to rapidly build DSLs,} 
 
-◊li{students who wish to explore a potential area of research for a PhD, and}
+◊li{students who wish to explore a potential area of research for a PhD,}
 
 ◊li{faculty at all levels who wish to explore an approach to teaching LOP.}
 
@@ -198,6 +199,11 @@ border-radius: 0.5rem;
 
 Eventbrite fees are added during checkout.
 
+◊h3{◊xtarget{Housing}}
+
+Subsidized housing is available in the University of Utah campus dorms. The cost is $40/night. ◊link["https://forms.gle/spaMYg1LL4CK3J8p9"]{Register here.}
+
+
 
 ◊h3{◊xtarget["previous"]{Previous Racket Schools}}