Thread overview
Do we need a FAQ page?
Aug 29, 2016
Andrea Fontana
Aug 29, 2016
jmh530
Aug 29, 2016
Andrea Fontana
Aug 29, 2016
Cauterite
Aug 29, 2016
bachmeier
Aug 29, 2016
Seb
Aug 29, 2016
bachmeier
Aug 29, 2016
bachmeier
Aug 30, 2016
Suliman
August 29, 2016
A lot of people has prejudices about D (gc, speed, stability, etc...).
And recently I read some thread about this. Why there's no FAQ page on website with something like:

Does gc slowdown every program I write?
Can I avoid garbage collector on my programs?
Is D slower than C++?
Is D still under development?

blah blah.

Andrea
August 29, 2016
On Monday, 29 August 2016 at 13:36:05 UTC, Andrea Fontana wrote:
> A lot of people has prejudices about D (gc, speed, stability, etc...).
> And recently I read some thread about this. Why there's no FAQ page on website with something like:
>
> Does gc slowdown every program I write?
> Can I avoid garbage collector on my programs?
> Is D slower than C++?
> Is D still under development?
>
> blah blah.
>
> Andrea

https://dlang.org/faq.html
August 29, 2016
On Monday, 29 August 2016 at 13:46:29 UTC, jmh530 wrote:
> On Monday, 29 August 2016 at 13:36:05 UTC, Andrea Fontana wrote:
>> A lot of people has prejudices about D (gc, speed, stability, etc...).
>> And recently I read some thread about this. Why there's no FAQ page on website with something like:
>>
>> Does gc slowdown every program I write?
>> Can I avoid garbage collector on my programs?
>> Is D slower than C++?
>> Is D still under development?
>>
>> blah blah.
>>
>> Andrea
>
> https://dlang.org/faq.html

It's very deep inside menu.
Anyway this FAQ sections sounds not right for a newcomer that never seen D IMO.
August 29, 2016
On Monday, 29 August 2016 at 13:50:07 UTC, Andrea Fontana wrote:
> It's very deep inside menu.
> Anyway this FAQ sections sounds not right for a newcomer that never seen D IMO.

You can actually fork the website ( https://github.com/dlang/dlang.org/blob/master/faq.dd ) and improve it yourself if you feel so inclined. I'm sure many of us will be happy to help you smooth it over once you get the ball rolling.

I agree that the FAQ page is far from ideal, and horribly out of date in many places.
August 29, 2016
On Monday, 29 August 2016 at 15:29:40 UTC, Cauterite wrote:
> You can actually fork the website ( https://github.com/dlang/dlang.org/blob/master/faq.dd ) and improve it yourself if you feel so inclined. I'm sure many of us will be happy to help you smooth it over once you get the ball rolling.

Maybe, but an alternative is that someone will spend a bunch of time changing the website and then others won't agree, so it will be wasted.

In addition to needing the FAQ at the highest level of the menus, we need a reference to Ali's book. The old website had it listed as one of the top items as the "official tutorial". Now it's buried and nobody will know it is the official tutorial even in the unlikely event that they do find it.
August 29, 2016
On Monday, 29 August 2016 at 15:53:54 UTC, bachmeier wrote:
> On Monday, 29 August 2016 at 15:29:40 UTC, Cauterite wrote:
>> You can actually fork the website ( https://github.com/dlang/dlang.org/blob/master/faq.dd ) and improve it yourself if you feel so inclined. I'm sure many of us will be happy to help you smooth it over once you get the ball rolling.
>
> Maybe, but an alternative is that someone will spend a bunch of time changing the website and then others won't agree, so it will be wasted.
>
> In addition to needing the FAQ at the highest level of the menus, we need a reference to Ali's book. The old website had it listed as one of the top items as the "official tutorial". Now it's buried and nobody will know it is the official tutorial even in the unlikely event that they do find it.

Huh? It's directly in the "Learn" tab:

> For a deeper dive into D check out books about D, among others Ali Çehreli's Programming in D.

(it's also mentioned at a couple of other places on dlang.org)

Btw if would be an "official" tutorial, which afaik there isn't, the DLang Tour would be pretty close to it:

https://tour.dlang.org/

The main difference is the intended audience and length.
That being said the DLang Tour contains a whole bunch of reference for in-depth reading - nearly every page:

https://github.com/stonemaster/dlang-tour/pull/257
August 29, 2016
On Monday, 29 August 2016 at 16:17:39 UTC, Seb wrote:
>> In addition to needing the FAQ at the highest level of the menus, we need a reference to Ali's book. The old website had it listed as one of the top items as the "official tutorial". Now it's buried and nobody will know it is the official tutorial even in the unlikely event that they do find it.
>
> Huh? It's directly in the "Learn" tab:
>
>> For a deeper dive into D check out books about D, among others Ali Çehreli's Programming in D.
>
> (it's also mentioned at a couple of other places on dlang.org)

This is what the Learn tab links to on my computer: http://wiki.dlang.org/Getting_Started

That must have been changed recently, because it had been pointing to the DLang Tour.

>
> Btw if would be an "official" tutorial, which afaik there isn't,

Ali's book was called the official tutorial by Andrei, and before the website was changed, it had prominent placement at the top of the sidebar. Now it is just another book and there is no way to get to it from the menu.
August 29, 2016
On Monday, 29 August 2016 at 17:05:26 UTC, bachmeier wrote:

...

I see the difference now. The top menu on forum.dlang.org is different from the one on dlang.org.
August 30, 2016
I already wrote one alternative version. Dlang.ru is down, but on page there is germany translation version http://forum.dlang.org/thread/vxmieatguqfkwgzlifaj@forum.dlang.org