www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.announce - The D language online tour - tour.dlang.org

reply =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
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é
May 16 2016
next sibling parent Vladimir Panteleev <thecybershadow.lists gmail.com> writes:
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?
May 16 2016
prev sibling next sibling parent Edwin van Leeuwen <edder tkwsping.nl> writes:
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?
May 16 2016
prev sibling next sibling parent reply Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
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
May 16 2016
parent reply Jack Stouffer <jack jackstouffer.com> writes:
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/
May 16 2016
parent reply =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
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!
May 17 2016
parent reply Shammah Chancellor <shammah.chancellor gmail.com> writes:
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.
May 24 2016
parent reply Seb <seb wilzba.ch> writes:
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?
May 24 2016
parent =?UTF-8?Q?Ali_=c3=87ehreli?= <acehreli yahoo.com> writes:
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_onl
ne_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



 May 25 2016



prev sibling next sibling parent  Martin Nowak <code+news.digitalmars dawg.eu>  writes:


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



 May 16 2016



prev sibling next sibling parent  Mark Isaacson <turck11 hotmail.com>  writes:


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 :).



 May 16 2016



prev sibling next sibling parent  Saurabh Das <saurabh.das gmail.com>  writes:


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.



 May 16 2016



prev sibling next sibling parent reply Vadim Lopatin <coolreader.org gmail.com>  writes:


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é


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...



 May 17 2016



  parent reply =?UTF-8?B?QW5kcsOp?= <Andre nospam.org>  writes:


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é



 May 17 2016



  parent  =?UTF-8?Q?Ali_=c3=87ehreli?= <acehreli yahoo.com>  writes:


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



 May 25 2016



prev sibling next sibling parent reply marcpmichel <marc.p.michel gmail.com>  writes:


 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".



 May 25 2016



  parent reply Seb <seb wilzba.ch>  writes:


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!



 May 25 2016



  parent reply Steven Schveighoffer <schveiguy yahoo.com>  writes:


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



 May 25 2016



  parent reply =?UTF-8?Q?Ali_=c3=87ehreli?= <acehreli yahoo.com>  writes:


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



 May 25 2016



  parent reply Steven Schveighoffer <schveiguy yahoo.com>  writes:


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



 May 25 2016



 next sibling parent  =?UTF-8?Q?Ali_=c3=87ehreli?= <acehreli yahoo.com>  writes:


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



 May 25 2016



prev sibling  parent  =?UTF-8?Q?Ali_=c3=87ehreli?= <acehreli yahoo.com>  writes:


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



 May 25 2016



prev sibling next sibling parent  Ozan <ozan.sueel gmail.com>  writes:


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



 May 25 2016



prev sibling next sibling parent reply Andrew Edwards <edwards.ac gmail.com>  writes:


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



 May 27 2016



  parent reply Seb <seb wilzba.ch>  writes:


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



 May 27 2016



  parent  Andrew Edwards <edwards.ac gmail.com>  writes:


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.



 May 28 2016



prev sibling  parent reply Martin Tschierschke <mt smartdolphin.de>  writes:


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



 Jun 10 2016



  parent  Seb <seb wilzba.ch>  writes:


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



 Jun 10 2016