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!

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.

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?

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

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

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

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!

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

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

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