Re: The D language online tour - tour.dlang.org
On Friday, 10 June 2016 at 09:18:07 UTC, Martin Tschierschke wrote: On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André I just yesterday managed to go trough the tour - great work! Just a few suggestions: a) There should be a direct link to a form on every page to give feedback, if you find an error, if you are new it is way to complicated to search for the "right" place to put hints for broken links or similar errors. Yep we are aware of this (https://github.com/stonemaster/dlang-tour/issues/37) and once we split the tour into separate files (PR is already pending - https://github.com/stonemaster/dlang-tour/pull/224), this will happen! b) The broken link is here: http://tour.dlang.org/tour/welcome/4 Dub Repository points to: (http:// is missing) http://tour.dlang.org/tour/welcome/code.dlang.org Reported: https://github.com/stonemaster/dlang-tour/pull/230 Thanks! c) It would be very nice if the "swipe gesture" on an pad would be detected. Or alternatively the forward an back button should be on the top to. Hehe we have had similar ideas: https://github.com/stonemaster/dlang-tour/pull/221 d) It would be very useful to add direct links to the chapters of: Programming in D from Ali Çehreli Already part of our roadmap - we just need a bit more man power ;-) https://github.com/stonemaster/dlang-tour/issues/193
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André I just yesterday managed to go trough the tour - great work! Just a few suggestions: a) There should be a direct link to a form on every page to give feedback, if you find an error, if you are new it is way to complicated to search for the "right" place to put hints for broken links or similar errors. b) The broken link is here: http://tour.dlang.org/tour/welcome/4 Dub Repository points to: (http:// is missing) http://tour.dlang.org/tour/welcome/code.dlang.org c) It would be very nice if the "swipe gesture" on an pad would be detected. Or alternatively the forward an back button should be on the top to. d) It would be very useful to add direct links to the chapters of: Programming in D from Ali Çehreli
Re: The D language online tour - tour.dlang.org
On 5/28/16 4:23 AM, Seb wrote: On Friday, 27 May 2016 at 19:18:11 UTC, Andrew Edwards wrote: On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: [...] Hello André, Congratulations. Job well done on a much need resource for the community. I sent you an email almost two weeks ago via your website. Not sure if you received it since I did not receive a response. Please contact me via email. My address is plastered all around the forum. Thanks, Andrew Hi Andrew, have you tried to open a Github issue for it? [1] It's quite active over there. [1] https://github.com/stonemaster/dlang-tour Would if had an issue with it I suppose. This is regarding something totally different. Just noticed your email response. Will reply there.
Re: The D language online tour - tour.dlang.org
On Friday, 27 May 2016 at 19:18:11 UTC, Andrew Edwards wrote: On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: [...] Hello André, Congratulations. Job well done on a much need resource for the community. I sent you an email almost two weeks ago via your website. Not sure if you received it since I did not receive a response. Please contact me via email. My address is plastered all around the forum. Thanks, Andrew Hi Andrew, have you tried to open a Github issue for it? [1] It's quite active over there. [1] https://github.com/stonemaster/dlang-tour
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André Hello André, Congratulations. Job well done on a much need resource for the community. I sent you an email almost two weeks ago via your website. Not sure if you received it since I did not receive a response. Please contact me via email. My address is plastered all around the forum. Thanks, Andrew
Re: The D language online tour - tour.dlang.org
On 05/25/2016 10:46 AM, Steven Schveighoffer wrote: http://ddili.org/ders/d.en/if.html#ix_if.else%20if "Have coffee at neighbor's" Thank you, fixed. Ali
[OT] Re: The D language online tour - tour.dlang.org
On 05/25/2016 10:46 AM, Steven Schveighoffer wrote: On 5/25/16 1:22 PM, Ali Çehreli wrote: On 05/25/2016 08:18 AM, Steven Schveighoffer wrote: IMO, just say "if and else are your friends", as "else if" is really not it's own construct. I like my own description of "else if" here: :) http://ddili.org/ders/d.en/if.html#ix_if.else%20if "Have coffee at neighbor's" or "Have coffee with neighbor" -Steve You know what... I'm done with the English language. (or perhaps "with English" or "on English" or "by English", etc.) :p Ali
Re: The D language online tour - tour.dlang.org
On 5/25/16 1:22 PM, Ali Çehreli wrote: On 05/25/2016 08:18 AM, Steven Schveighoffer wrote: IMO, just say "if and else are your friends", as "else if" is really not it's own construct. I like my own description of "else if" here: :) http://ddili.org/ders/d.en/if.html#ix_if.else%20if "Have coffee at neighbor's" or "Have coffee with neighbor" -Steve
Re: The D language online tour - tour.dlang.org
On 05/25/2016 08:18 AM, Steven Schveighoffer wrote: IMO, just say "if and else are your friends", as "else if" is really not it's own construct. I like my own description of "else if" here: :) http://ddili.org/ders/d.en/if.html#ix_if.else%20if Ali
Re: The D language online tour - tour.dlang.org
On 05/17/2016 02:00 AM, André wrote: > Another more fundamental question: Is a translation really needed for > the tour? Definitely. > I am not a native speaker but I still prefer reading technical > stuff in English especially when English is the language of the > original. It's hard for me to estimate the value of a translation.. I know many people who seek translations of technical documentation. Ali
Re: The D language online tour - tour.dlang.org
On 5/25/16 9:42 AM, Seb wrote: On Wednesday, 25 May 2016 at 11:46:55 UTC, marcpmichel wrote: I think it's "if, else and else if are tour friends". Hmm that doesn't make sense to me either. How can "if" be a "tour friend". That being said I agree the current wording isn't optimal - do you want to open a PR to fix it? I think he meant "else if" instead of "if else" and "tour friends" was a typo ;) IMO, just say "if and else are your friends", as "else if" is really not it's own construct. -Steve
Re: The D language online tour - tour.dlang.org
On Wednesday, 25 May 2016 at 11:46:55 UTC, marcpmichel wrote: I think it's "if, else and else if are tour friends". Hmm that doesn't make sense to me either. How can "if" be a "tour friend". That being said I agree the current wording isn't optimal - do you want to open a PR to fix it? https://github.com/stonemaster/dlang-tour/blob/master/public/content/en/basics.md @Ali: Issue opened: https://github.com/stonemaster/dlang-tour/issues/187 https://github.com/stonemaster/dlang-tour/issues/188 The latter is a more fundendamental "design" decisions, so your voices count!
Re: The D language online tour - tour.dlang.org
On 05/24/2016 05:17 PM, Seb wrote: > On Tuesday, 24 May 2016 at 23:11:07 UTC, Shammah Chancellor wrote: >> On Tuesday, 17 May 2016 at 09:02:04 UTC, André wrote: >>> On Monday, 16 May 2016 at 20:39:26 UTC, Jack Stouffer wrote: On Monday, 16 May 2016 at 18:02:29 UTC, Andrei Alexandrescu wrote: > This is great work, thanks! Please announce in social media as > well! -- Andrei Reddit: https://www.reddit.com/r/programming/comments/4jn6ks/the_online_d_language_tour/ >>> >>> Thanks! >> >> Hey, great site! Really glad this was done. The interface is a tiny >> bit confusing. At the end of the welcome it's not clear you need to >> goto the "Basics" tab to continue on. All the strings should probably >> just be tied together. >> >> -S. > > Could you point out why it is confusing to you. I had the same experience. The page number is 5/5 and the arrows are grayed out. That looks like "the end" to me. > Currently the text says: > > "Either use the navigation panel at the bottom or press the right arrow > key." But before that, it says "Congratulations for finishing the first chapter. You're now ready to dive into the world of D." which may (and did to me) mean "this is the end, go out there and try out D now." It's easy to miss "first chapter" in there. > What could we add to avoid the confusion? 1) Arrows should not be gray (how about green?) 2) 5/5 doesn't carry much meaning for me and potentially confusing as it did Somewhat related, it would be better if we had arrows at the top of the page as well, which would not move relative to the person's mouse position. When I want to flip a few pages back or forward, I should not hunt for the arrow with the mouse after potentially moving the page up. Ali
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André That's really cool stuff. Congratulations! Regards, Ozan
Re: The D language online tour - tour.dlang.org
http://tour.dlang.org/ On the "Controlling flow" page, the first paragraph says : Sometimes you have to control your application's flow depending on input parameters. if, else and if else are your friends then: I think it's "if, else and else if are tour friends".
Re: The D language online tour - tour.dlang.org
On Tuesday, 24 May 2016 at 23:11:07 UTC, Shammah Chancellor wrote: On Tuesday, 17 May 2016 at 09:02:04 UTC, André wrote: On Monday, 16 May 2016 at 20:39:26 UTC, Jack Stouffer wrote: On Monday, 16 May 2016 at 18:02:29 UTC, Andrei Alexandrescu wrote: This is great work, thanks! Please announce in social media as well! -- Andrei Reddit: https://www.reddit.com/r/programming/comments/4jn6ks/the_online_d_language_tour/ Thanks! Hey, great site! Really glad this was done. The interface is a tiny bit confusing. At the end of the welcome it's not clear you need to goto the "Basics" tab to continue on. All the strings should probably just be tied together. -S. Could you point out why it is confusing to you. Currently the text says: "Either use the navigation panel at the bottom or press the right arrow key." What could we add to avoid the confusion?
Re: The D language online tour - tour.dlang.org
On Tuesday, 17 May 2016 at 09:02:04 UTC, André wrote: On Monday, 16 May 2016 at 20:39:26 UTC, Jack Stouffer wrote: On Monday, 16 May 2016 at 18:02:29 UTC, Andrei Alexandrescu wrote: This is great work, thanks! Please announce in social media as well! -- Andrei Reddit: https://www.reddit.com/r/programming/comments/4jn6ks/the_online_d_language_tour/ Thanks! Hey, great site! Really glad this was done. The interface is a tiny bit confusing. At the end of the welcome it's not clear you need to goto the "Basics" tab to continue on. All the strings should probably just be tied together. -S.
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 20:39:26 UTC, Jack Stouffer wrote: On Monday, 16 May 2016 at 18:02:29 UTC, Andrei Alexandrescu wrote: This is great work, thanks! Please announce in social media as well! -- Andrei Reddit: https://www.reddit.com/r/programming/comments/4jn6ks/the_online_d_language_tour/ Thanks!
Re: The D language online tour - tour.dlang.org
On Tuesday, 17 May 2016 at 08:52:57 UTC, Vadim Lopatin wrote: It would be great to have translations of this tour to other languages. Is it hard to add language selection? I could help with Russian translation... It shouldn't be hard, because the technical basis is there; it just needs to be made available to the user. But I would suggest waiting until to start an effort to translate the tour into other languages until the content has gone through some rounds of reviewing and the number of pulls/errors in the content is very low. Another more fundamental question: Is a translation really needed for the tour? I am not a native speaker but I still prefer reading technical stuff in English especially when English is the language of the original. It's hard for me to estimate the value of a translation.. Thanks & regards, André
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André This is really great! It is a good step into making D friendlier for new users.
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 18:02:29 UTC, Andrei Alexandrescu wrote: This is great work, thanks! Please announce in social media as well! -- Andrei Reddit: https://www.reddit.com/r/programming/comments/4jn6ks/the_online_d_language_tour/
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André This is awesome! My one complaint would be that the D logo in the upper left corner should probably go to dlang.org, not tour.dlang.org :).
Re: The D language online tour - tour.dlang.org
On 05/16/2016 07:32 PM, André wrote: > Hi, > > after another round of polishing, bug fixing, very useful user > contributions and suggestions, I'd like to present the new home of the D > language online tour: > > http://tour.dlang.org/ > > Thank you very much to the D foundation for hosting this service! How is this deployed, don't know the server? Can anyone give me details? > If you would like to report errors or have suggestions, please use GitHub: > > https://github.com/stonemaster/dlang-tour Nice, I always wanted to do such a markdown tutorial on top of my D REPL. Glad you did it first ;). Small PR https://github.com/stonemaster/dlang-tour/pull/62 -Martin
Re: The D language online tour - tour.dlang.org
On 05/16/2016 01:32 PM, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André This is great work, thanks! Please announce in social media as well! -- Andrei
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Thank you very much to the D foundation for hosting this service! If you would like to report errors or have suggestions, please use GitHub: https://github.com/stonemaster/dlang-tour Thanks & regards, André Nice work. Will this be mentioned/linked too in the Learn section of the dlang.org?
Re: The D language online tour - tour.dlang.org
On Monday, 16 May 2016 at 17:32:06 UTC, André wrote: Hi, after another round of polishing, bug fixing, very useful user contributions and suggestions, I'd like to present the new home of the D language online tour: http://tour.dlang.org/ Awesome! As I mentioned on GitHub, we should aim towards making the tour the target of the "Learn" link in the top navigation bar. So, how about integrating the contents of http://dlang.org/getstarted.html into the first page (or first few pages) of the tour? Thank you very much to the D foundation for hosting this service! Hey, this is news to me. What are the details?