digitalmars.D - Website message overhaul, pass 2
- Andrei Alexandrescu (13/13) Nov 20 2011 Thanks to all who provided feedback! I read again the entire thread,
- Jonathan M Davis (31/46) Nov 20 2011 Overall. It looks good. It's also more compact, which is probably a good...
- Andrei Alexandrescu (15/44) Nov 20 2011 Done.
- Paulo Pinto (11/24) Nov 20 2011 Looks great.
- Jude Young (2/33) Nov 20 2011 Nice catch. It does indeed sound better your way.
- Derek (6/22) Nov 20 2011 I think "naturally" can be removed altogether.
- Andrej Mitrovic (1/1) Nov 20 2011 Clicking Example doesn't do anything. And yes I have javascript on. :)
- Andrei Alexandrescu (3/4) Nov 20 2011 I only noticed that now... will look into it.
- Andrei Alexandrescu (4/24) Nov 20 2011 "Naturally" emphasizes that we're not talking about the "reasonably
- Derek (8/14) Nov 20 2011 Ok, I see where you are going with that now; it wasn't obvious to me. So...
- Andrei Alexandrescu (3/11) Nov 20 2011 Done.
- Danni Coy (3/7) Nov 20 2011 I think that naturally applies to D rather than compiles
- Andrei Alexandrescu (3/10) Nov 20 2011 That Yoda sounds said like.
- Andrei Alexandrescu (13/30) Nov 20 2011 On second thought, this seems glib, apologies.
- Jonathan M Davis (8/22) Nov 20 2011 Well, if it were "Naturally, D compiles to efficient, native code," then...
- Robert Clipsham (35/48) Nov 20 2011 This is a huge improvement! Ignoring the broken +Example links:
- Peter Alexander (24/54) Nov 20 2011 It's hard to come up with something that is short, easily-understandable...
- Peter Alexander (3/11) Nov 20 2011 Ignore the CTFE with regex, it doesn't do any CTFE. Maybe I was thinking...
- Andrei Alexandrescu (3/23) Nov 20 2011 Great. Save that for the contest.
- Dmitry Olshansky (8/63) Nov 23 2011 Well, soon you'd get CTFE and compile-time goodies...
- Andrei Alexandrescu (15/45) Nov 20 2011 I'd be curious how with only a couple of lines more you address in C
- Robert Clipsham (15/34) Nov 20 2011 I don't have time to write up an example, however a C/C++ programmer
- Andrei Alexandrescu (3/9) Nov 20 2011 Tried that, too narrow.
- Jerry (13/34) Nov 25 2011 I had one minor thought on the average line length code example. If you
- Peter Alexander (24/27) Nov 20 2011 Much better :-)
- Jonathan M Davis (7/22) Nov 20 2011 Making it a link to wikipedia should be plenty. The C++ will know what R...
- Peter Alexander (5/26) Nov 20 2011 I just think it's a terrible acronym and that we shouldn't be promoting
- Jonathan M Davis (4/35) Nov 20 2011 It's well-established at this point. It would _increase_ confusion for m...
- Peter Alexander (7/42) Nov 20 2011 It's *only* established in the C++ community, and I would even suspect
- Adam D. Ruppe (6/6) Nov 20 2011 RAII confused me at first because it doesn't really have anything to do ...
- Andrei Alexandrescu (3/9) Nov 20 2011 Adjusted text.
- Andrei Alexandrescu (7/29) Nov 20 2011 Good point, will keep in mind.
- Jesse Phillips (2/10) Nov 20 2011 On top of that, #! is only available to the *nix world.
- Andrei Alexandrescu (3/13) Nov 20 2011 And cygwin.
- Peter Alexander (4/11) Nov 20 2011 How about being more vague?
- Vladimir Panteleev (10/17) Nov 20 2011 I would like to humbly suggest a change in the punctuation of the top
- Robert Clipsham (10/13) Nov 20 2011 Too many capitals!
- Jimmy Cao (7/20) Nov 20 2011 I agree. If you have each four as its own sentence, it gives them equal
- Jonathan M Davis (6/20) Nov 20 2011 I completly disagree. It's the title. You're _supposed_ to capitalize th...
- Robert Clipsham (5/25) Nov 21 2011 It's a title?! Oh yeah, scrap then, capitalise it all.
- Jimmy Cao (6/27) Nov 20 2011 colon.
- Jude Young (8/8) Nov 20 2011 Just a heads up, d-p-l.org/download.html results in an infinite
- Andrei Alexandrescu (3/11) Nov 20 2011 We're on that.
- Andrej Mitrovic (1/1) Nov 20 2011 LOL, some ISP is gonna have its stack blown!
- Andrei Alexandrescu (4/15) Nov 20 2011 Arranged things such that +Example becomes -Example when expanded. Also,...
- bearophile (49/53) Nov 20 2011 On Wikipedia they are asking for some changes:
- Andrei Alexandrescu (6/6) Nov 20 2011 On 11/20/11 4:45 PM, bearophile wrote:
- Andrei Alexandrescu (9/12) Nov 20 2011 I made one more pass and improved the homepage in a number of ways.
- Brad Roberts (9/30) Nov 20 2011 One thing that's annoyed me for a while about the pages.. the last updat...
- Andrei Alexandrescu (3/5) Nov 20 2011 Moved the date to the footer.
- David Gileadi (7/11) Nov 22 2011 I had planned this when I first worked on the site redesign. I did some...
- Andrei Alexandrescu (4/17) Nov 20 2011 I got word that not all browsers display the Unicode + and -, so I
- Kapps (17/30) Nov 20 2011 I think it actually looks quite nice.
- Kapps (3/41) Nov 20 2011 Also, the title is currently "- The D Programming Language". I assume
- Andrei Alexandrescu (3/5) Nov 20 2011 Not seeing that.
- Kapps (9/14) Nov 20 2011 It definitely seems to be part of the page.
- Andrei Alexandrescu (3/8) Nov 20 2011 Oh, got it. Fixed.
- tn (2/10) Nov 21 2011 The page starts to look good. But the title ("The D programming language...
- Derek (5/10) Nov 21 2011 Yes!
- Peter Alexander (3/10) Nov 21 2011 Agree.
- Robert Clipsham (15/28) Nov 21 2011 Something that's just annoyed me thoroughly now you've done this (though...
- Andrei Alexandrescu (4/29) Nov 21 2011 It's not a title.
- Jonathan M Davis (3/8) Nov 21 2011 Then what is it? It's sure not a sentence, and it's at the top of the pa...
- Andrei Alexandrescu (3/11) Nov 21 2011 Section header.
- Jimmy Cao (7/25) Nov 21 2011 This is an urgent fix of utmost grammatical importance:
- Jonathan M Davis (8/33) Nov 21 2011 1. It's odd to call the header on the top of the page something other th...
- Adam Richardson (18/54) Nov 21 2011 Insisting that titles be capitalized to match typical print publication
- Andrei Alexandrescu (3/12) Nov 23 2011 I decided to undo this artificial limitation. Sorry.
- Don (16/29) Nov 21 2011 First, a comment. I like the word "control" in the first line. Along
- Matt Soucy (5/18) Nov 21 2011 It looks pretty good in my opinion - just one tiny problem: the first
- Brad Anderson (9/22) Nov 22 2011 Solid improvements.
- Andrei Alexandrescu (3/8) Nov 22 2011 Fixed. Also added [your code here] at the end of the top example. Try it...
- Andrej Mitrovic (4/4) Nov 23 2011 Please, *please* don't make the website narrow like this:
- Andrei Alexandrescu (3/7) Nov 23 2011 Ah, yah. Fixed. Thanks!
- Andrei Alexandrescu (3/11) Nov 23 2011 I also made the slogan H2 instead of H1.
- Jimmy Cao (2/17) Nov 23 2011 You should also put a colon (to make it grammatically correct).
- Jonathan M Davis (5/10) Nov 23 2011 Yeah. That's pretty bad. I'd have expected the site to vary its width
- RivenTheMage (2/3) Nov 23 2011 There is an error, I believe: "scope statements" link should point to
- Andrej Mitrovic (1/1) Nov 23 2011 Thanks for the quick fix Andrei. :-)
- Andrei Alexandrescu (3/6) Nov 23 2011 Fixed. Thanks!
- Martin Nowak (8/21) Nov 24 2011 The css appears to be broken for
- Caligo (3/3) Nov 28 2011 BTW, something is wrong with the class section of the language reference...
- Jacob Carlborg (4/7) Nov 28 2011 There's a pull request available but it hasn't been merged.
Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, Andrei
Nov 20 2011
On Sunday, November 20, 2011 02:40:09 Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest.Overall. It looks good. It's also more compact, which is probably a good thing. One thing that bothered me right off the bat though is "modeling power" in that my first reaction is "what kind of modeling power?" It feels to me like it needs an adjective in front of it. It's probably fine though - particularly since I can't think of what to put in front of it (high?). The thought behind it is solid, but I guess that the phrase is just a bit odd to me. Nitpick: "giving the best of the static and dynamic worlds" would be slightly better IMHO as "giving the best of both the static and the dynamic worlds." Nitpick: The + on the Example link is a nice improvement, but ideally it would change to a - when the example is visible. That might be more complicated than it's worth though. I don't know (since I'm not a web programmer). Nitpick: "Best paradigm is to not impose..." sounds odd. Do you mean "The best paradigm..." or something else? Maybe it should be something more like "It is best to not impose one programming paradigm at the expense of others." Suggestion: Make RAII in the text a link to RAII on wikipedia. Also, scope should probably be turned into a link to scope statements in the documenation. I really like the idea of having the prominent example rotate randomly from a list somewhere, but of course, that means that we need to come up with such a list, and coming up with good, concise examples like that generally seems to be difficult. If we can come up with even just a few though, it would still be a nice touch over having one, static example. I find it interesting that whatever you did with the news section this time around actually shows up properly in Konqueror, whereas before it didn't (Konqueror is generally quite standards compliant, but that doesn't always translate to showing stuff correctly - especially with advanced web 2.0 kind of stuff). Overall, it looks good to me. But from the previous comments, I think that others are far pickier than I am about the content (e.g. multi-paradigm was fine with me). - Jonathan M Davis
Nov 20 2011
On 11/20/11 3:10 AM, Jonathan M Davis wrote:Overall. It looks good. It's also more compact, which is probably a good thing. One thing that bothered me right off the bat though is "modeling power" in that my first reaction is "what kind of modeling power?" It feels to me like it needs an adjective in front of it. It's probably fine though - particularly since I can't think of what to put in front of it (high?). The thought behind it is solid, but I guess that the phrase is just a bit odd to me.Keeping this in mind.Nitpick: "giving the best of the static and dynamic worlds" would be slightly better IMHO as "giving the best of both the static and the dynamic worlds."Done.Nitpick: The + on the Example link is a nice improvement, but ideally it would change to a - when the example is visible. That might be more complicated than it's worth though. I don't know (since I'm not a web programmer).Yes, that's part of the plan. Note that the "+" is a nice small Unicode "+", and probably the "-" will be the small Unicode "-".Nitpick: "Best paradigm is to not impose..." sounds odd. Do you mean "The best paradigm..." or something else? Maybe it should be something more like "It is best to not impose one programming paradigm at the expense of others."I wanted to put there a strong sentence a la "best organization is disorganization". I thought "best paradigm is no paradigm" but that would be too extreme.Suggestion: Make RAII in the text a link to RAII on wikipedia. Also, scope should probably be turned into a link to scope statements in the documenation.Done.I really like the idea of having the prominent example rotate randomly from a list somewhere, but of course, that means that we need to come up with such a list, and coming up with good, concise examples like that generally seems to be difficult. If we can come up with even just a few though, it would still be a nice touch over having one, static example.I'm sure we will. I wonder how I can superimpose on the code frame a small text in the bottom right saying "[your code here]" linked to a submission form. That way we advertise the contest right where the prize is!I find it interesting that whatever you did with the news section this time around actually shows up properly in Konqueror, whereas before it didn't (Konqueror is generally quite standards compliant, but that doesn't always translate to showing stuff correctly - especially with advanced web 2.0 kind of stuff).I issued a window.stop() after the twitter code.Overall, it looks good to me. But from the previous comments, I think that others are far pickier than I am about the content (e.g. multi-paradigm was fine with me).Thanks for your input! Andrei
Nov 20 2011
Looks great. While I am not native English speaker, would it not be better to exachange the position of *naturally* and *compiles* on the following sentence? From: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code." -- Paulo Am 20.11.2011 09:40, schrieb Andrei Alexandrescu:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, Andrei
Nov 20 2011
On Sun 20 Nov 2011 05:09:28 AM CST, Paulo Pinto wrote:Looks great. While I am not native English speaker, would it not be better to exachange the position of *naturally* and *compiles* on the following sentence? From: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code." -- Paulo Am 20.11.2011 09:40, schrieb Andrei Alexandrescu:Nice catch. It does indeed sound better your way.Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, Andrei
Nov 20 2011
On Sun, 20 Nov 2011 22:40:34 +1100, Jude Young <10equals2 gmail.com> wrote:On Sun 20 Nov 2011 05:09:28 AM CST, Paulo Pinto wrote:I think "naturally" can be removed altogether. "D compiles to efficient machine code." -- Derek Parnell Melbourne, AustraliaLooks great. While I am not native English speaker, would it not be better to exachange the position of *naturally* and *compiles* on the following sentence? From: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code."Nice catch. It does indeed sound better your way.
Nov 20 2011
Clicking Example doesn't do anything. And yes I have javascript on. :)
Nov 20 2011
On 11/20/11 12:26 PM, Andrej Mitrovic wrote:Clicking Example doesn't do anything. And yes I have javascript on. :)I only noticed that now... will look into it. Andrei
Nov 20 2011
On 11/20/11 9:50 AM, Derek wrote:On Sun, 20 Nov 2011 22:40:34 +1100, Jude Young <10equals2 gmail.com> wrote:"Naturally" emphasizes that we're not talking about the "reasonably advanced compiler" myth. AndreiOn Sun 20 Nov 2011 05:09:28 AM CST, Paulo Pinto wrote:I think "naturally" can be removed altogether. "D compiles to efficient machine code."Looks great. While I am not native English speaker, would it not be better to exachange the position of *naturally* and *compiles* on the following sentence? From: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code."Nice catch. It does indeed sound better your way.
Nov 20 2011
On Mon, 21 Nov 2011 07:06:00 +1100, Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> wrote:Ok, I see where you are going with that now; it wasn't obvious to me. So rephrasing it and using more words, - the nature of D makes it simple to generate efficient machine code. -- Derek Parnell Melbourne, AustraliaI think "naturally" can be removed altogether. "D compiles to efficient machine code.""Naturally" emphasizes that we're not talking about the "reasonably advanced compiler" myth.
Nov 20 2011
On 11/20/11 5:09 AM, Paulo Pinto wrote:Looks great. While I am not native English speaker, would it not be better to exachange the position of *naturally* and *compiles* on the following sentence? From: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code."Done. Andrei
Nov 20 2011
From: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code."I think that naturally applies to D rather than compiles so perhaps "Naturally D compiles to efficient native code."
Nov 20 2011
On 11/20/11 5:22 PM, Danni Coy wrote:From: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code." I think that naturally applies to D rather than compiles so perhaps "Naturally D compiles to efficient native code."That Yoda sounds said like. Andrei
Nov 20 2011
On 11/20/11 5:31 PM, Andrei Alexandrescu wrote:On 11/20/11 5:22 PM, Danni Coy wrote:On second thought, this seems glib, apologies. What I really meant to say is that "natural" actually goes to the process of compilation, not D itself. You can see that by replacing e.g. "natural" with "easy": D compiles easily to efficient native code. That's what I meant when writing the sentence, and again it's there to avoid the fallacy that you'd need a magically advanced compiler to do that. In fact I've considered adding one more sentence there, but I can't come up with anything short and good. Something like: "D builds structure on top of C's object model bedrock, so D compiles naturally to efficient native code." That is long-ish and, worse, leads to all sorts of mistaken interpretations. AndreiFrom: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code." I think that naturally applies to D rather than compiles so perhaps "Naturally D compiles to efficient native code."That Yoda sounds said like. Andrei
Nov 20 2011
On Sunday, November 20, 2011 17:31:57 Andrei Alexandrescu wrote:On 11/20/11 5:22 PM, Danni Coy wrote:Well, if it were "Naturally, D compiles to efficient, native code," then it means something similar to "Obviously, D compiles to efficient, native code." But the naturally that the original phrase uses is a different definition. So, yes, if naturally were to keep the same meaning with this suggested rewrite, it would be Yoda-talk, but most people would probably take it as a different meaning of the word entirely. - Jonathan M DavisFrom: "D naturally compiles to efficient native code." To: "D compiles naturally to efficient native code." I think that naturally applies to D rather than compiles so perhaps "Naturally D compiles to efficient native code."That Yoda sounds said like.
Nov 20 2011
On 20/11/2011 08:40, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, AndreiThis is a huge improvement! Ignoring the broken +Example links: - The code sample at the top is terrible, the equivalent C is only a couple of lines longer and it doesn't show off any of what makes D better! Admittedly you're limited in what you can do here as the code needs to be fairly understandable by non-D programmers, but what's there is... Not good at all. - Rotating the example is a brilliant idea, particularly if powered by a continuous contest. - This is less about the message, but how about an "explain this" link in the corner of examples with little hints for C/C++/Java programmers, so when clicked additional comments appear in the code or bubbles appear above on hover or something, they would include small bits of text like "auto can be used in place of a type to infer the type from what is being assigned"... But better worded of course. - Maybe it's just me, but I don't like the title being so long. I think "The D Programming Language" on its own is fine. The rest of it may still have a place, but it needs to be elsewhere in my opinion (even if it just moves to the line below). - Your summary sentence at the start reads "It pragmatically combines efficiency, control, and modeling power, with safety and programmer productivity." You then go on to talk about convinience, power and efficiency... http://en.wikipedia.org/wiki/Topic_sentence The sentence needs to be changed to reflect what you go on to detail below - currently you're making statements without backing them up (note that you do back up most of it, not all of it though, and the subheadings don't make it obvious where you can find out more about the claims). - convinience -> convenience - I can't really fault the bullet points, they're a huge improvement. - I have a reasonably large screen and can't see the news section without scrolling. To me this means there is no news ;) I'm starting to nit-pick, it must be getting better. -- Robert http://octarineparrot.com/
Nov 20 2011
On 20/11/11 1:09 PM, Robert Clipsham wrote:- The code sample at the top is terrible, the equivalent C is only a couple of lines longer and it doesn't show off any of what makes D better! Admittedly you're limited in what you can do here as the code needs to be fairly understandable by non-D programmers, but what's there is... Not good at all.It's hard to come up with something that is short, easily-understandable and demonstrates D's (numerous) powerful features. How about this one: // Match email addresses on each line of standard input // using a compile-time generated regular expression engine. import std.stdio, std.regex; void main() { string email = r"\b[A-Z0-9._%+-]+ [A-Z0-9.-]+\.[A-Z]{2,4}\b"; foreach (line; stdin.byLine()) { foreach (m; match(line, regex(email, "i"))) { writefln("%s[%s]%s", m.pre, m.hit, m.post); } } } Demonstrates: - Syntax - Imports - Raw string literals - Foreach with type deduction - CTFE with regex - "Batteries included" library (std.byLine(), regex, match, writefln) - General succinctness of D code- Rotating the example is a brilliant idea, particularly if powered by a continuous contest. - This is less about the message, but how about an "explain this" link in the corner of examples with little hints for C/C++/Java programmers, so when clicked additional comments appear in the code or bubbles appear above on hover or something, they would include small bits of text like "auto can be used in place of a type to infer the type from what is being assigned"... But better worded of course. - Maybe it's just me, but I don't like the title being so long. I think "The D Programming Language" on its own is fine. The rest of it may still have a place, but it needs to be elsewhere in my opinion (even if it just moves to the line below). - Your summary sentence at the start reads "It pragmatically combines efficiency, control, and modeling power, with safety and programmer productivity." You then go on to talk about convinience, power and efficiency... http://en.wikipedia.org/wiki/Topic_sentence The sentence needs to be changed to reflect what you go on to detail below - currently you're making statements without backing them up (note that you do back up most of it, not all of it though, and the subheadings don't make it obvious where you can find out more about the claims). - convinience -> convenience - I can't really fault the bullet points, they're a huge improvement. - I have a reasonably large screen and can't see the news section without scrolling. To me this means there is no news ;) I'm starting to nit-pick, it must be getting better.+1 to everything
Nov 20 2011
On 20/11/11 2:17 PM, Peter Alexander wrote:Demonstrates: - Syntax - Imports - Raw string literals - Foreach with type deduction - CTFE with regex - "Batteries included" library (std.byLine(), regex, match, writefln) - General succinctness of D codeIgnore the CTFE with regex, it doesn't do any CTFE. Maybe I was thinking of the new one?
Nov 20 2011
On 11/20/11 8:17 AM, Peter Alexander wrote:How about this one: // Match email addresses on each line of standard input // using a compile-time generated regular expression engine. import std.stdio, std.regex; void main() { string email = r"\b[A-Z0-9._%+-]+ [A-Z0-9.-]+\.[A-Z]{2,4}\b"; foreach (line; stdin.byLine()) { foreach (m; match(line, regex(email, "i"))) { writefln("%s[%s]%s", m.pre, m.hit, m.post); } } } Demonstrates: - Syntax - Imports - Raw string literals - Foreach with type deduction - CTFE with regex - "Batteries included" library (std.byLine(), regex, match, writefln) - General succinctness of D codeGreat. Save that for the contest. Andrei
Nov 20 2011
On 20.11.2011 18:17, Peter Alexander wrote:On 20/11/11 1:09 PM, Robert Clipsham wrote:Well, soon you'd get CTFE and compile-time goodies... Then just swap it with: auto email = ctRegex!(r"\b[A-Z0-9._%+-]+ [A-Z0-9.-]+\.[A-Z]{2,4}\b","i"); just keep in mind that it's fairly new and experimental stuff.- The code sample at the top is terrible, the equivalent C is only a couple of lines longer and it doesn't show off any of what makes D better! Admittedly you're limited in what you can do here as the code needs to be fairly understandable by non-D programmers, but what's there is... Not good at all.It's hard to come up with something that is short, easily-understandable and demonstrates D's (numerous) powerful features. How about this one: // Match email addresses on each line of standard input // using a compile-time generated regular expression engine. import std.stdio, std.regex; void main() { string email = r"\b[A-Z0-9._%+-]+ [A-Z0-9.-]+\.[A-Z]{2,4}\b";foreach (line; stdin.byLine()) { foreach (m; match(line, email))) { writefln("%s[%s]%s", m.pre, m.hit, m.post); } } } Demonstrates: - Syntax - Imports - Raw string literals - Foreach with type deduction - CTFE with regex - "Batteries included" library (std.byLine(), regex, match, writefln) - General succinctness of D codeBack to topic, I'm also pleased with the recent improvements. -- Dmitry Olshansky- Rotating the example is a brilliant idea, particularly if powered by a continuous contest. - This is less about the message, but how about an "explain this" link in the corner of examples with little hints for C/C++/Java programmers, so when clicked additional comments appear in the code or bubbles appear above on hover or something, they would include small bits of text like "auto can be used in place of a type to infer the type from what is being assigned"... But better worded of course. - Maybe it's just me, but I don't like the title being so long. I think "The D Programming Language" on its own is fine. The rest of it may still have a place, but it needs to be elsewhere in my opinion (even if it just moves to the line below). - Your summary sentence at the start reads "It pragmatically combines efficiency, control, and modeling power, with safety and programmer productivity." You then go on to talk about convinience, power and efficiency... http://en.wikipedia.org/wiki/Topic_sentence The sentence needs to be changed to reflect what you go on to detail below - currently you're making statements without backing them up (note that you do back up most of it, not all of it though, and the subheadings don't make it obvious where you can find out more about the claims). - convinience -> convenience - I can't really fault the bullet points, they're a huge improvement. - I have a reasonably large screen and can't see the news section without scrolling. To me this means there is no news ;) I'm starting to nit-pick, it must be getting better.+1 to everything
Nov 23 2011
On 11/20/11 7:09 AM, Robert Clipsham wrote:- The code sample at the top is terrible, the equivalent C is only a couple of lines longer and it doesn't show off any of what makes D better! Admittedly you're limited in what you can do here as the code needs to be fairly understandable by non-D programmers, but what's there is... Not good at all.I'd be curious how with only a couple of lines more you address in C lines of arbitrary length and proper error handling. Same goes about C++ (in addition to the speed issue) - code that does the right thing and is not very slow is quite subtle and I doubt two out of five C++ programmers know how to write it.- Rotating the example is a brilliant idea, particularly if powered by a continuous contest.Yah, looking forward to that. It's going to be interesting.- This is less about the message, but how about an "explain this" link in the corner of examples with little hints for C/C++/Java programmers, so when clicked additional comments appear in the code or bubbles appear above on hover or something, they would include small bits of text like "auto can be used in place of a type to infer the type from what is being assigned"... But better worded of course.Good idea.- Maybe it's just me, but I don't like the title being so long. I think "The D Programming Language" on its own is fine. The rest of it may still have a place, but it needs to be elsewhere in my opinion (even if it just moves to the line below).I like that the main message is small enough to allow formatting in large font.- Your summary sentence at the start reads "It pragmatically combines efficiency, control, and modeling power, with safety and programmer productivity." You then go on to talk about convinience, power and efficiency... http://en.wikipedia.org/wiki/Topic_sentence The sentence needs to be changed to reflect what you go on to detail below - currently you're making statements without backing them up (note that you do back up most of it, not all of it though, and the subheadings don't make it obvious where you can find out more about the claims).Agreed. I'll think of fixing that.- convinience -> convenienceWhere?- I can't really fault the bullet points, they're a huge improvement. - I have a reasonably large screen and can't see the news section without scrolling. To me this means there is no news ;)I'm considering moving the news on the right-hand side.I'm starting to nit-pick, it must be getting better.Thanks for the feedback! Andrei
Nov 20 2011
On 20/11/2011 19:55, Andrei Alexandrescu wrote:On 11/20/11 7:09 AM, Robert Clipsham wrote:I don't have time to write up an example, however a C/C++ programmer reading that code would have no idea any error handling was happening.- The code sample at the top is terrible, the equivalent C is only a couple of lines longer and it doesn't show off any of what makes D better! Admittedly you're limited in what you can do here as the code needs to be fairly understandable by non-D programmers, but what's there is... Not good at all.I'd be curious how with only a couple of lines more you address in C lines of arbitrary length and proper error handling. Same goes about C++ (in addition to the speed issue) - code that does the right thing and is not very slow is quite subtle and I doubt two out of five C++ programmers know how to write it.I like that the main message is small enough to allow formatting in large font.I personally don't find it very readable with it all being on one line, I feel breaking it into two looks far nicer (I did try).No idea! :D- convinience -> convenienceWhere?I think it would be quite good to put it in the already existent sidebar - as I've already mentioned, I don't see the sidebar unless I really look for it (it looks too much like it's part of the background)... With a bit of tweaking I think you could make it more noticeable (without being intrusive) and have the twitter feed in there (thus saving horizontal space for those with small screens). -- Robert http://octarineparrot.com/- I can't really fault the bullet points, they're a huge improvement. - I have a reasonably large screen and can't see the news section without scrolling. To me this means there is no news ;)I'm considering moving the news on the right-hand side.
Nov 20 2011
On 11/20/11 5:43 PM, Robert Clipsham wrote:I think it would be quite good to put it in the already existent sidebar - as I've already mentioned, I don't see the sidebar unless I really look for it (it looks too much like it's part of the background)... With a bit of tweaking I think you could make it more noticeable (without being intrusive) and have the twitter feed in there (thus saving horizontal space for those with small screens).Tried that, too narrow. Andrei
Nov 20 2011
Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:On 11/20/11 7:09 AM, Robert Clipsham wrote:I had one minor thought on the average line length code example. If you eliminate the initialization of lines and sumLength, it would demonstrate default initialization.- The code sample at the top is terrible, the equivalent C is only a couple of lines longer and it doesn't show off any of what makes D better! Admittedly you're limited in what you can do here as the code needs to be fairly understandable by non-D programmers, but what's there is... Not good at all.I'd be curious how with only a couple of lines more you address in C lines of arbitrary length and proper error handling. Same goes about C++ (in addition to the speed issue) - code that does the right thing and is not very slow is quite subtle and I doubt two out of five C++ programmers know how to write it.What do you think about offering equivalent code from other languages? Not necessarily all language for any given example, but if there are enough equivalents from enough other languages, it might more directly highlight the strengths of D for newbies with those backgrounds. So in this case a perl comparison wouldn't be illuminating but a C++ one would. If all the various paradigms that D supports get illustrated that way it might give a broader feeling for how D will make things easier on many fronts. Jerry- Rotating the example is a brilliant idea, particularly if powered by a continuous contest.Yah, looking forward to that. It's going to be interesting.- This is less about the message, but how about an "explain this" link in the corner of examples with little hints for C/C++/Java programmers, so when clicked additional comments appear in the code or bubbles appear above on hover or something, they would include small bits of text like "auto can be used in place of a type to infer the type from what is being assigned"... But better worded of course.Good idea.
Nov 25 2011
On 20/11/11 8:40 AM, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/Much better :-) A few comments: Can we please not use the term RAII? First, only C++ people know what it means, and second, its expansion doesn't tell you what it does or what it is used for. Just say something like "scoped deterministic memory management" or something like that. I'm sure C++ people will link that to RAII, and non-C++ people will have a better idea of what it means. I think the point about the shebang line is unnecessary. It's a certainly a nice feature, but doesn't feel important enough to me to warrant being on the front-page trying to sell the language. Perhaps something about version/debug blocks would be more appropriate as they're something that everyone uses. "Without preventing virtual machine approaches, D naturally compiles to efficient native code." I would add onto the end of that "rivaling and often bettering the runtime performance of raw C and C++ code." That's what people really want to hear, and it doesn't hurt to be explicit about it. With this point: "The safe, trusted, and system modular attributes allow the programmer to best decide the safety/efficiency tradeoffs of a particular application, and have the compiler check for consistency." I'm not sure the reader can get much from that without knowing what those attributes mean.
Nov 20 2011
On Sunday, November 20, 2011 13:47:31 Peter Alexander wrote:On 20/11/11 8:40 AM, Andrei Alexandrescu wrote:Making it a link to wikipedia should be plenty. The C++ will know what RAII is, and anyone who's learning D should learn it. The combination of an example, the brief explanation that's there, and a link to Wikipedia should be plenty for people to be able to figure out what they need to know. And it _is_ a very important feature for those who know what it means. - Jonathan M DavisThanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/Much better :-) A few comments: Can we please not use the term RAII? First, only C++ people know what it means, and second, its expansion doesn't tell you what it does or what it is used for. Just say something like "scoped deterministic memory management" or something like that. I'm sure C++ people will link that to RAII, and non-C++ people will have a better idea of what it means.
Nov 20 2011
On 20/11/11 1:46 PM, Jonathan M Davis wrote:On Sunday, November 20, 2011 13:47:31 Peter Alexander wrote:I just think it's a terrible acronym and that we shouldn't be promoting its use. What part of "resource acquisition is initialization" tells me that its main purpose is deterministic, scoped resource management? They should learn the concept but not the acronym ;-)On 20/11/11 8:40 AM, Andrei Alexandrescu wrote:Making it a link to wikipedia should be plenty. The C++ will know what RAII is, and anyone who's learning D should learn it. The combination of an example, the brief explanation that's there, and a link to Wikipedia should be plenty for people to be able to figure out what they need to know. And it _is_ a very important feature for those who know what it means.Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/Much better :-) A few comments: Can we please not use the term RAII? First, only C++ people know what it means, and second, its expansion doesn't tell you what it does or what it is used for. Just say something like "scoped deterministic memory management" or something like that. I'm sure C++ people will link that to RAII, and non-C++ people will have a better idea of what it means.
Nov 20 2011
On Sunday, November 20, 2011 14:22:16 Peter Alexander wrote:On 20/11/11 1:46 PM, Jonathan M Davis wrote:It's well-established at this point. It would _increase_ confusion for many if we tried to avoid the term. - Jonathan M DavisOn Sunday, November 20, 2011 13:47:31 Peter Alexander wrote:I just think it's a terrible acronym and that we shouldn't be promoting its use. What part of "resource acquisition is initialization" tells me that its main purpose is deterministic, scoped resource management? They should learn the concept but not the acronym ;-)On 20/11/11 8:40 AM, Andrei Alexandrescu wrote:Making it a link to wikipedia should be plenty. The C++ will know what RAII is, and anyone who's learning D should learn it. The combination of an example, the brief explanation that's there, and a link to Wikipedia should be plenty for people to be able to figure out what they need to know. And it _is_ a very important feature for those who know what it means.Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/Much better :-) A few comments: Can we please not use the term RAII? First, only C++ people know what it means, and second, its expansion doesn't tell you what it does or what it is used for. Just say something like "scoped deterministic memory management" or something like that. I'm sure C++ people will link that to RAII, and non-C++ people will have a better idea of what it means.
Nov 20 2011
On 20/11/11 2:20 PM, Jonathan M Davis wrote:On Sunday, November 20, 2011 14:22:16 Peter Alexander wrote:It's *only* established in the C++ community, and I would even suspect that majority of working C++ programmers don't know what it means (even though they know the concept). The vast majority of programmers (i.e. non-C++ programmers) have no idea what it means, can't tell from the name, and when they learn it they'll have no why it was called that.On 20/11/11 1:46 PM, Jonathan M Davis wrote:It's well-established at this point. It would _increase_ confusion for many if we tried to avoid the term. - Jonathan M DavisOn Sunday, November 20, 2011 13:47:31 Peter Alexander wrote:I just think it's a terrible acronym and that we shouldn't be promoting its use. What part of "resource acquisition is initialization" tells me that its main purpose is deterministic, scoped resource management? They should learn the concept but not the acronym ;-)On 20/11/11 8:40 AM, Andrei Alexandrescu wrote:Making it a link to wikipedia should be plenty. The C++ will know what RAII is, and anyone who's learning D should learn it. The combination of an example, the brief explanation that's there, and a link to Wikipedia should be plenty for people to be able to figure out what they need to know. And it _is_ a very important feature for those who know what it means.Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/Much better :-) A few comments: Can we please not use the term RAII? First, only C++ people know what it means, and second, its expansion doesn't tell you what it does or what it is used for. Just say something like "scoped deterministic memory management" or something like that. I'm sure C++ people will link that to RAII, and non-C++ people will have a better idea of what it means.
Nov 20 2011
RAII confused me at first because it doesn't really have anything to do with resource acquisition or initilaization! RAII is more about scoped destructors than anything else... the opposite of what the name implies. I know what it means now, but I see where Peter Alexander is coming from. It's not an intuitive name.
Nov 20 2011
On 11/20/11 8:36 AM, Adam D. Ruppe wrote:RAII confused me at first because it doesn't really have anything to do with resource acquisition or initilaization! RAII is more about scoped destructors than anything else... the opposite of what the name implies. I know what it means now, but I see where Peter Alexander is coming from. It's not an intuitive name.Adjusted text. Andrei
Nov 20 2011
On 11/20/11 7:47 AM, Peter Alexander wrote:A few comments: Can we please not use the term RAII? First, only C++ people know what it means, and second, its expansion doesn't tell you what it does or what it is used for. Just say something like "scoped deterministic memory management" or something like that. I'm sure C++ people will link that to RAII, and non-C++ people will have a better idea of what it means.I think RAII+link is fine. It's an awful acronym, but it has caught on.I think the point about the shebang line is unnecessary. It's a certainly a nice feature, but doesn't feel important enough to me to warrant being on the front-page trying to sell the language. Perhaps something about version/debug blocks would be more appropriate as they're something that everyone uses.Good point, will keep in mind."Without preventing virtual machine approaches, D naturally compiles to efficient native code." I would add onto the end of that "rivaling and often bettering the runtime performance of raw C and C++ code." That's what people really want to hear, and it doesn't hurt to be explicit about it."No mention of other languages." Well I broke that with C-like syntax because that's very informative.With this point: "The safe, trusted, and system modular attributes allow the programmer to best decide the safety/efficiency tradeoffs of a particular application, and have the compiler check for consistency." I'm not sure the reader can get much from that without knowing what those attributes mean.There's an article link for those interested. Andrei
Nov 20 2011
On Sun, 20 Nov 2011 13:58:14 -0600, Andrei Alexandrescu wrote:On 11/20/11 7:47 AM, Peter Alexander wrote:I think the point about the shebang line is unnecessary. It's a certainly a nice feature, but doesn't feel important enough to me to warrant being on the front-page trying to sell the language. Perhaps something about version/debug blocks would be more appropriate as they're something that everyone uses.Good point, will keep in mind.
Nov 20 2011
On 11/20/11 3:01 PM, Jesse Phillips wrote:On Sun, 20 Nov 2011 13:58:14 -0600, Andrei Alexandrescu wrote:And cygwin. AndreiOn 11/20/11 7:47 AM, Peter Alexander wrote:I think the point about the shebang line is unnecessary. It's a certainly a nice feature, but doesn't feel important enough to me to warrant being on the front-page trying to sell the language. Perhaps something about version/debug blocks would be more appropriate as they're something that everyone uses.Good point, will keep in mind.
Nov 20 2011
On 20/11/11 7:58 PM, Andrei Alexandrescu wrote:How about being more vague? "rivalling and often bettering the runtime performance of other systems programming languages.""Without preventing virtual machine approaches, D naturally compiles to efficient native code." I would add onto the end of that "rivaling and often bettering the runtime performance of raw C and C++ code." That's what people really want to hear, and it doesn't hurt to be explicit about it."No mention of other languages." Well I broke that with C-like syntax because that's very informative.
Nov 20 2011
On Sun, 20 Nov 2011 10:40:09 +0200, Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I would like to humbly suggest a change in the punctuation of the top heading. From this:The D programming language. Modern convenience. Modeling power. Native efficiency.To this:The D Programming Language: Modern Convenience, Modeling Power, Native EfficiencyI'm not sure about the capitalization, but the period-overloaded version reads in my head like a lame car commercial. -- Best regards, Vladimir mailto:vladimir thecybershadow.net
Nov 20 2011
On 20/11/2011 21:49, Vladimir Panteleev wrote:Too many capitals! The D Programming Language: Modern convenience, modeling power, native efficiency. The - Start of a sentence D Programming Language - a noun. Modern - comes after a colon. -- Robert http://octarineparrot.com/The D Programming Language: Modern Convenience, Modeling Power, Native EfficiencyI'm not sure about the capitalization
Nov 20 2011
2011/11/20 Robert Clipsham <robert octarineparrot.com>On 20/11/2011 21:49, Vladimir Panteleev wrote:I agree. If you have each four as its own sentence, it gives them equal emphasis, which is strange. "The D Programming Language" should be the primary statement, followed by a colon, and then an enumeration of those four selling points. Although, I think that listing the selling points like that is silly and that "Welcome to D" would suffice.The D Programming Language: Modern Convenience, Modeling Power, NativeToo many capitals! The D Programming Language: Modern convenience, modeling power, native efficiency. The - Start of a sentence D Programming Language - a noun. Modern - comes after a colon.EfficiencyI'm not sure about the capitalization
Nov 20 2011
On Sunday, November 20, 2011 23:47:42 Robert Clipsham wrote:On 20/11/2011 21:49, Vladimir Panteleev wrote:I completly disagree. It's the title. You're _supposed_ to capitalize there. It looks just plain wrong to not capitalize those words. If it were in a sentence, that would be one thing, but titles follow different rules of capitalization. - Jonathan M DavisToo many capitals! The D Programming Language: Modern convenience, modeling power, native efficiency. The - Start of a sentence D Programming Language - a noun. Modern - comes after a colon.The D Programming Language: Modern Convenience, Modeling Power, Native EfficiencyI'm not sure about the capitalization
Nov 20 2011
On 21/11/2011 00:13, Jonathan M Davis wrote:On Sunday, November 20, 2011 23:47:42 Robert Clipsham wrote:It's a title?! Oh yeah, scrap then, capitalise it all. -- Robert http://octarineparrot.com/On 20/11/2011 21:49, Vladimir Panteleev wrote:I completly disagree. It's the title. You're _supposed_ to capitalize there. It looks just plain wrong to not capitalize those words. If it were in a sentence, that would be one thing, but titles follow different rules of capitalization. - Jonathan M DavisToo many capitals! The D Programming Language: Modern convenience, modeling power, native efficiency. The - Start of a sentence D Programming Language - a noun. Modern - comes after a colon.The D Programming Language: Modern Convenience, Modeling Power, Native EfficiencyI'm not sure about the capitalization
Nov 21 2011
2011/11/20 Jonathan M Davis <jmdavisProg gmx.com>On Sunday, November 20, 2011 23:47:42 Robert Clipsham wrote:colon. What makes more sense? Ducks. Tasty. Feathers. Buoyant. or Ducks: Tasty, Feathers, Bouyant.On 20/11/2011 21:49, Vladimir Panteleev wrote:I completly disagree. It's the title. You're _supposed_ to capitalize there. It looks just plain wrong to not capitalize those words. If it were in a sentence, that would be one thing, but titles follow different rules of capitalization. The biggest problem is the title's equal emphasis. There should be aToo many capitals! The D Programming Language: Modern convenience, modeling power, native efficiency. The - Start of a sentence D Programming Language - a noun. Modern - comes after a colon.The D Programming Language: Modern Convenience, Modeling Power, Native EfficiencyI'm not sure about the capitalization
Nov 20 2011
Just a heads up, d-p-l.org/download.html results in an infinite redirect loop for me. digitalmars.com redirects to d-p-l. In other words, there is no longer any way to download the dmd compiler. Also, http://www.d-programming-language.org/1.0/index.html (D1 home on the sidebar) doesn't exist. We're looking good with the website though!
Nov 20 2011
On 11/20/11 7:40 PM, Jude Young wrote:Just a heads up, d-p-l.org/download.html results in an infinite redirect loop for me. digitalmars.com redirects to d-p-l. In other words, there is no longer any way to download the dmd compiler. Also, http://www.d-programming-language.org/1.0/index.html (D1 home on the sidebar) doesn't exist. We're looking good with the website though!We're on that. Andrei
Nov 20 2011
LOL, some ISP is gonna have its stack blown!
Nov 20 2011
On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest.Arranged things such that +Example becomes -Example when expanded. Also, examples are now clickable while the page is still loading. Andrei
Nov 20 2011
Andrei Alexandrescu:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/On Wikipedia they are asking for some changes: http://en.wikipedia.org/wiki/D_language (We don't want to use this on the front page: import std.stdio, std.string, std.algorithm; void main() { string[][string] signature2words; foreach (char[] line; lines(File("words.txt"))) { auto cline = line.chomp(); string word = cline.idup; cline.toLowerInPlace(); (cast(ubyte[])cline).sort(); signature2words[cline.idup] ~= word; } foreach (words; signature2words) if (words.length > 1) writefln(words.join(" ")); } ------------------------------- I have modified a bit your text, this is not meant to be a final version, but shows a text I like a bit more: The D programming language // Finds and prints word anagrams import std.stdio, std.string, std.algorithm; void main() { dstring[][dstring] signature2words; foreach (dstring line; lines(File("words.txt"))) { auto word = line.chomp(); auto key = word.toLower().dup.sort().release().idup; signature2words[key] ~= word; } foreach (words; signature2words) if (words.length > 1) writefln(words.join(" ")); } D is a statically typed language with C-like syntax. It tries to combine efficiency and control with safety and programmer productivity. Convenience * The simple type inference of D allow writing code with no redundant type specifications, while keeping static typing safety and efficiency. [Example] * The optional garbage collector makes for simple and safe code. D also supports scoped resource management (the RAII idiom) and scope statements for ....... code that is easy to read. [Example] * Array slicing syntax, built-in dynamic arrays and associative arrays, and several other features allow to write handy short script-like programs succinctly and safely. Power * D supports classic polymorphism, value semantics, functional style, generics, generative programming and contract programming. [Example] * D offers an innovative approach to concurrency featuring true immutable data, message passing, no sharing by default, pure functions and controlled mutable sharing across threads. Read more. * D scales to larger projects with unit testing, information hiding, refined modularity, fast compilation and precise interfaces. Read more. Efficiency * D compiles naturally to efficient native code. * D is designed such that most obvious code is fast and safe. On occasion you might need to escape the confines of type safety for ultimate speed and control. For such rare cases D offers native pointers, type casts, access to any C function without any intervening translation, and even inline assembly. So D allows to mix high level code and low level code in the same program. [Example] * The safe, trusted, and system modular attributes allow the programmer to best decide the safety/efficiency tradeoffs of a particular application, and have the compiler check for consistency. Read more. Bye, bearophile
Nov 20 2011
On 11/20/11 4:45 PM, bearophile wrote: [snip] Thanks for your feedback! Operated a few changes. I think the example introduces too many concepts. Thanks again, Andrei
Nov 20 2011
On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...) * The news column is now on the right. * Border is thinner * The page behaves better when shrinking laterally * Footer is better integrated * Copyright text is smaller Andrei
Nov 20 2011
On 11/20/2011 9:31 PM, Andrei Alexandrescu wrote:On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:One thing that's annoyed me for a while about the pages.. the last updated date does not deserve such prominent placement, imho. Second, if the 'comment on this page' link is going to continue to receive similar placement, there really needs to be continuous effort to actually incorporate the comments. Many, if not all, of the sites pages have comments over in the wiki, many of which are bug reports. It's essentially a black hole through which feedback disappears forever. Should that link be turned into a bugzilla link instead, maybe? Later, BradThanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...) * The news column is now on the right. * Border is thinner * The page behaves better when shrinking laterally * Footer is better integrated * Copyright text is smaller Andrei
Nov 20 2011
On 11/21/11 12:00 AM, Brad Roberts wrote:One thing that's annoyed me for a while about the pages.. the last updated date does not deserve such prominent placement, imho.Moved the date to the footer. Andrei
Nov 20 2011
On 11/20/11 11:00 PM, Brad Roberts wrote:Second, if the 'comment on this page' link is going to continue to receive similar placement, there really needs to be continuous effort to actually incorporate the comments. Many, if not all, of the sites pages have comments over in the wiki, many of which are bug reports. It's essentially a black hole through which feedback disappears forever. Should that link be turned into a bugzilla link instead, maybe?I had planned this when I first worked on the site redesign. I did some work on implementing it via Javascript and this could work if there were a service on the dpl.org site that scrapes the HTML from the wiki. Of course the larger question is whether we want user comments to appear on every page. I tend to think that a bugzilla link may be more appropriate, with an appropriate link text change.
Nov 22 2011
On 11/20/11 11:31 PM, Andrei Alexandrescu wrote:On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:I got word that not all browsers display the Unicode + and -, so I replaced the text with "See example" and "Hide example". AndreiThanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...) * The news column is now on the right. * Border is thinner * The page behaves better when shrinking laterally * Footer is better integrated * Copyright text is smaller Andrei
Nov 20 2011
I think it actually looks quite nice. Some issues: I really think it should be Expand/Contract Example instead of +/- Example. Having +/- after a period just seems... strange. Example Convenience[1] uses 'dictionary' as the name of the AA, then references it by using 'table'. Example Convenience[2] uses new Widget. This goes against property I believe, and would probably not work with -property. a unix thing (at the very least, Windows command prompt does not support basic examples for a cross-platform language. It will either confuse the user if they don't know what it is, perhaps making them think it's part them wonder whether things like Windows are treated second-hand when it's all they see. On 20/11/2011 11:31 PM, Andrei Alexandrescu wrote:On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...) * The news column is now on the right. * Border is thinner * The page behaves better when shrinking laterally * Footer is better integrated * Copyright text is smaller Andrei
Nov 20 2011
Also, the title is currently "- The D Programming Language". I assume that "- " at the start shouldn't be there? On 21/11/2011 1:28 AM, Kapps wrote:I think it actually looks quite nice. Some issues: I really think it should be Expand/Contract Example instead of +/- Example. Having +/- after a period just seems... strange. Example Convenience[1] uses 'dictionary' as the name of the AA, then references it by using 'table'. Example Convenience[2] uses new Widget. This goes against property I believe, and would probably not work with -property. a unix thing (at the very least, Windows command prompt does not support basic examples for a cross-platform language. It will either confuse the user if they don't know what it is, perhaps making them think it's part them wonder whether things like Windows are treated second-hand when it's all they see. On 20/11/2011 11:31 PM, Andrei Alexandrescu wrote:On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...) * The news column is now on the right. * Border is thinner * The page behaves better when shrinking laterally * Footer is better integrated * Copyright text is smaller Andrei
Nov 20 2011
On 11/21/11 1:34 AM, Kapps wrote:Also, the title is currently "- The D Programming Language". I assume that "- " at the start shouldn't be there?Not seeing that. Andrei
Nov 20 2011
It definitely seems to be part of the page. Source on Firefox 8.0 - Windows - After cache clear: <meta name="description" content="D Programming Language" /> <title> - D Programming Language</title> <link rel="stylesheet" type="text/css" href="css/style.css" /> Source on Debian machine from curl: curl -s http://d-programming-language.org/new/ | grep "<title>" <title> - D Programming Language</title> On 21/11/2011 1:45 AM, Andrei Alexandrescu wrote:On 11/21/11 1:34 AM, Kapps wrote:Also, the title is currently "- The D Programming Language". I assume that "- " at the start shouldn't be there?Not seeing that. Andrei
Nov 20 2011
On 11/21/11 1:45 AM, Andrei Alexandrescu wrote:On 11/21/11 1:34 AM, Kapps wrote:Oh, got it. Fixed. AndreiAlso, the title is currently "- The D Programming Language". I assume that "- " at the start shouldn't be there?Not seeing that. Andrei
Nov 20 2011
Andrei Alexandrescu Wrote:On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:The page starts to look good. But the title ("The D programming language. Modern convenience. Modeling power. Native efficiency.") is too long and hard to read. I would shorten it to something like "The D programming language - Convenience, Power, Efficiency" or even "The D programming language".Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...)
Nov 21 2011
On Mon, 21 Nov 2011 19:02:39 +1100, tn <no email.com> wrote:The page starts to look good. But the title ("The D programming language. Modern convenience. Modeling power. Native efficiency.") is too long and hard to read. I would shorten it to something like "The D programming language - Convenience, Power, Efficiency" or even "The D programming language".Yes! -- Derek Parnell Melbourne, Australia
Nov 21 2011
On 21/11/11 8:23 AM, Derek wrote:On Mon, 21 Nov 2011 19:02:39 +1100, tn <no email.com> wrote:Agree. It also splits over a line for me, which is kind of ugly for a title.The page starts to look good. But the title ("The D programming language. Modern convenience. Modeling power. Native efficiency.") is too long and hard to read. I would shorten it to something like "The D programming language - Convenience, Power, Efficiency" or even "The D programming language".Yes!
Nov 21 2011
On 21/11/2011 05:31, Andrei Alexandrescu wrote:On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:Something that's just annoyed me thoroughly now you've done this (though it didn't before for some reason) - my eyes have to look all over the place to see everything on the screen. Please use something like: body { max-width: 1300px; margin: 0px auto; } This won't be noticeable for smaller screens, but on larger screens it makes the page a lot more readable.Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...) * The news column is now on the right.* Border is thinner * The page behaves better when shrinking laterallyOn my laptop's screen (1280x800, not the smallest) the title doesn't fit on one line. Titles should not be so long!* Footer is better integrated * Copyright text is smaller Andrei-- Robert http://octarineparrot.com/
Nov 21 2011
On 11/21/11 11:56 AM, Robert Clipsham wrote:On 21/11/2011 05:31, Andrei Alexandrescu wrote:Set it to 1600px.On 11/20/11 2:40 AM, Andrei Alexandrescu wrote:Something that's just annoyed me thoroughly now you've done this (though it didn't before for some reason) - my eyes have to look all over the place to see everything on the screen. Please use something like: body { max-width: 1300px; margin: 0px auto; }Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/I made one more pass and improved the homepage in a number of ways. (Learned about <div> more than I ever wanted to know...) * The news column is now on the right.This won't be noticeable for smaller screens, but on larger screens it makes the page a lot more readable.It's not a title. Andrei* Border is thinner * The page behaves better when shrinking laterallyOn my laptop's screen (1280x800, not the smallest) the title doesn't fit on one line. Titles should not be so long!
Nov 21 2011
On Monday, November 21, 2011 12:33:19 Andrei Alexandrescu wrote:On 11/21/11 11:56 AM, Robert Clipsham wrote:Then what is it? It's sure not a sentence, and it's at the top of the page. - Jonathan M DavisOn my laptop's screen (1280x800, not the smallest) the title doesn't fit on one line. Titles should not be so long!It's not a title.
Nov 21 2011
On 11/21/11 12:50 PM, Jonathan M Davis wrote:On Monday, November 21, 2011 12:33:19 Andrei Alexandrescu wrote:Section header. AndreiOn 11/21/11 11:56 AM, Robert Clipsham wrote:Then what is it? It's sure not a sentence, and it's at the top of the page. - Jonathan M DavisOn my laptop's screen (1280x800, not the smallest) the title doesn't fit on one line. Titles should not be so long!It's not a title.
Nov 21 2011
2011/11/21 Andrei Alexandrescu <SeeWebsiteForEmail erdani.org>On 11/21/11 12:50 PM, Jonathan M Davis wrote:This is an urgent fix of utmost grammatical importance: The D programming language. Modern convenience. Modeling power. Native efficiency. -> The D Programming Language: Modern Convenience, Modeling Power, and Native Efficiency A dash in place of the colon would also work. A section header is a title, so capitalize accordingly.On Monday, November 21, 2011 12:33:19 Andrei Alexandrescu wrote:Section header.On 11/21/11 11:56 AM, Robert Clipsham wrote:Then what is it? It's sure not a sentence, and it's at the top of the page. - Jonathan M DavisOn my laptop's screen (1280x800, not the smallest) the title doesn't fit on one line. Titles should not be so long!It's not a title.
Nov 21 2011
On Monday, November 21, 2011 13:35:21 Jimmy Cao wrote:2011/11/21 Andrei Alexandrescu <SeeWebsiteForEmail erdani.org>1. It's odd to call the header on the top of the page something other than a title IMHO, but it's a matter of semantics, I suppose. 2. Regardless of that, I would argue that section headers _are_ titles and should follow the same rules with regards to capitalization. Also, it should probably be a colon after "The D Programming Language" rather than a period. It makes more sense grammatically. - Jonathan M DavisOn 11/21/11 12:50 PM, Jonathan M Davis wrote:This is an urgent fix of utmost grammatical importance: The D programming language. Modern convenience. Modeling power. Native efficiency. -> The D Programming Language: Modern Convenience, Modeling Power, and Native Efficiency A dash in place of the colon would also work. A section header is a title, so capitalize accordingly.On Monday, November 21, 2011 12:33:19 Andrei Alexandrescu wrote:Section header.On 11/21/11 11:56 AM, Robert Clipsham wrote:Then what is it? It's sure not a sentence, and it's at the top of the page. - Jonathan M DavisOn my laptop's screen (1280x800, not the smallest) the title doesn't fit on one line. Titles should not be so long!It's not a title.
Nov 21 2011
On Mon, Nov 21, 2011 at 3:03 PM, Jonathan M Davis <jmdavisProg gmx.com>wrote:On Monday, November 21, 2011 13:35:21 Jimmy Cao wrote:Insisting that titles be capitalized to match typical print publication conventions is rather old school in terms of web development, and D is anything but old school :) Rather, the style guide for the site should be implemented consistently site-wide, and the capitalization scheme (which CAN require rules such as those outlined by the *The Chicago Manual of Style *, but, again, does not have to) should be addressed in the style guide: http://styleguide.yahoo.com/editing/treat-abbreviations-capitalization-and-titles-consistently/capitalization Styling depends on *what something is* and *where it is *in the flow of the page. A heading in an aside might be styled in sentence case as opposed to the same content appearing within the main header tag of a page, which might be title case. As long as the D website consistently follows the style choices laid out for the site, all will be well :) That said, the main header could benefit from the colon as pointed out by others, and the tagline could be improved. Steve Krug provides some great, quick insights on what makes a great tagline: http://www.amazon.com/Dont-Make-Me-Think-Usability/dp/0321344758 Adam2011/11/21 Andrei Alexandrescu <SeeWebsiteForEmail erdani.org>title,On 11/21/11 12:50 PM, Jonathan M Davis wrote:This is an urgent fix of utmost grammatical importance: The D programming language. Modern convenience. Modeling power. Native efficiency. -> The D Programming Language: Modern Convenience, Modeling Power, and Native Efficiency A dash in place of the colon would also work. A section header is aOn Monday, November 21, 2011 12:33:19 Andrei Alexandrescu wrote:Section header.On 11/21/11 11:56 AM, Robert Clipsham wrote:Then what is it? It's sure not a sentence, and it's at the top of the page. - Jonathan M DavisOn my laptop's screen (1280x800, not the smallest) the title doesn't fit on one line. Titles should not be so long!It's not a title.so capitalize accordingly.1. It's odd to call the header on the top of the page something other than a title IMHO, but it's a matter of semantics, I suppose. 2. Regardless of that, I would argue that section headers _are_ titles and should follow the same rules with regards to capitalization. Also, it should probably be a colon after "The D Programming Language" rather than a period. It makes more sense grammatically. - Jonathan M Davis
Nov 21 2011
On 11/21/11 11:56 AM, Robert Clipsham wrote:Something that's just annoyed me thoroughly now you've done this (though it didn't before for some reason) - my eyes have to look all over the place to see everything on the screen. Please use something like: body { max-width: 1300px; margin: 0px auto; } This won't be noticeable for smaller screens, but on larger screens it makes the page a lot more readable.I decided to undo this artificial limitation. Sorry. Andrei
Nov 23 2011
On 20.11.2011 09:40, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, AndreiFirst, a comment. I like the word "control" in the first line. Along with "pragmatic" it's IMHO one of the key themes of D. If asked for a slogan for D, I'd say, "Regain control with D". Consider replacing the "power" title with "control". Everybody claims power, far fewers languages claim control. "The best paradigm is to not impose one at the expense of others" I think the underlying idea, is that each paradigm is good for solving particular kinds of problems, but poor for others. I'm not quite sure how to word this, something like, "The best programming paradigm depends on the problem domain", or "No single paradigm is optimal for all problem domains". As others said, the word "naturally" here is a bit funny: "D compiles naturally to efficient native code." How about: "D compiles directly to efficient native code."
Nov 21 2011
On 11/20/2011 03:40 AM, Andrei Alexandrescu wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, AndreiIt looks pretty good in my opinion - just one tiny problem: the first sample code should use dictionary["two"] instead of table["two"] on line 8, so that it would actually compile. Other than that nitpick, and the fact that the download page is still on digitalmars.com, it looks great!
Nov 21 2011
On Sun, Nov 20, 2011 at 1:40 AM, Andrei Alexandrescu < SeeWebsiteForEmail erdani.org> wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.**org/new/<http://d-programming-language.org/new/> I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, AndreiSolid improvements. In the first example shouldn't: auto x = min(arr[0], table["two"]); be: auto x = min(arr[0], dictionary["two"]); Regards, Brad Anderson
Nov 22 2011
On 11/22/11 11:16 AM, Brad Anderson wrote:Solid improvements. In the first example shouldn't: auto x = min(arr[0], table["two"]); be: auto x = min(arr[0], dictionary["two"]);Fixed. Also added [your code here] at the end of the top example. Try it! Andrei
Nov 22 2011
Please, *please* don't make the website narrow like this: http://www.d-programming-language.org/new/phobos/std_algorithm.html This is only necessary for that twitter thing on the /new page, but don't make the entire website narrow because of that single page.
Nov 23 2011
On 11/23/11 11:23 AM, Andrej Mitrovic wrote:Please, *please* don't make the website narrow like this: http://www.d-programming-language.org/new/phobos/std_algorithm.html This is only necessary for that twitter thing on the /new page, but don't make the entire website narrow because of that single page.Ah, yah. Fixed. Thanks! Andrei
Nov 23 2011
On 11/23/11 11:40 AM, Andrei Alexandrescu wrote:On 11/23/11 11:23 AM, Andrej Mitrovic wrote:I also made the slogan H2 instead of H1. AndreiPlease, *please* don't make the website narrow like this: http://www.d-programming-language.org/new/phobos/std_algorithm.html This is only necessary for that twitter thing on the /new page, but don't make the entire website narrow because of that single page.Ah, yah. Fixed. Thanks! Andrei
Nov 23 2011
2011/11/23 Andrei Alexandrescu <SeeWebsiteForEmail erdani.org>On 11/23/11 11:40 AM, Andrei Alexandrescu wrote:You should also put a colon (to make it grammatically correct).On 11/23/11 11:23 AM, Andrej Mitrovic wrote:I also made the slogan H2 instead of H1.Please, *please* don't make the website narrow like this: http://www.d-programming-**language.org/new/phobos/std_**algorithm.html<http://www.d-programming-language.org/new/phobos/std_algorithm.html> This is only necessary for that twitter thing on the /new page, but don't make the entire website narrow because of that single page.Ah, yah. Fixed. Thanks! Andrei
Nov 23 2011
On Wednesday, November 23, 2011 18:23:11 Andrej Mitrovic wrote:Please, *please* don't make the website narrow like this: http://www.d-programming-language.org/new/phobos/std_algorithm.html This is only necessary for that twitter thing on the /new page, but don't make the entire website narrow because of that single page.Yeah. That's pretty bad. I'd have expected the site to vary its width depending on your browser window, not force itself to an insanely narrow width. - Jonathan M Davis
Nov 23 2011
http://d-programming-language.org/new/There is an error, I believe: "scope statements" link should point to #ScopeGuardStatement, not #ScopeBlockStatement.
Nov 23 2011
Thanks for the quick fix Andrei. :-)
Nov 23 2011
On 11/23/11 1:17 PM, RivenTheMage wrote:Fixed. Thanks! Andreihttp://d-programming-language.org/new/There is an error, I believe: "scope statements" link should point to #ScopeGuardStatement, not #ScopeBlockStatement.
Nov 23 2011
On Sun, 20 Nov 2011 09:40:09 +0100, Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> wrote:Thanks to all who provided feedback! I read again the entire thread, then made one more pass: http://d-programming-language.org/new/ I didn't make technical/aesthetic changes (JS/noJS, placement of news, links to secondary pages etc) so when providing additional feedback please focus on the core message. There are significant changes of content: some keywords are different, text is shorter, no more "community" section (probably it'll go on a different page). There's a prominent example at the top. I'm thinking to rotate that randomly, and pick examples out of an always-running contest. Thanks, AndreiThe css appears to be broken for http://d-programming-language.org/class.html as well as http://d-programming-language.org/new/class.html using Opera 11.52. martin
Nov 24 2011
BTW, something is wrong with the class section of the language reference: http://d-programming-language.org/new/class.html It's been like that for months.
Nov 28 2011
On 2011-11-29 08:40, Caligo wrote:BTW, something is wrong with the class section of the language reference: http://d-programming-language.org/new/class.html It's been like that for months.There's a pull request available but it hasn't been merged. -- /Jacob Carlborg
Nov 28 2011