-
-
Notifications
You must be signed in to change notification settings - Fork 56
/
Copy pathfeedback-sam.txt
101 lines (71 loc) · 3.98 KB
/
feedback-sam.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
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.