www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Do we need a FAQ page?

reply Andrea Fontana <nospam example.com> writes:
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
Aug 29 2016
parent reply jmh530 <john.michael.hall gmail.com> writes:
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
Aug 29 2016
parent reply Andrea Fontana <nospam example.com> writes:
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.
Aug 29 2016
parent reply Cauterite <cauterite gmail.com> writes:
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.
Aug 29 2016
parent reply bachmeier <no spam.net> writes:
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.
Aug 29 2016
parent reply Seb <seb wilzba.ch> writes:
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
Aug 29 2016
parent reply bachmeier <no spam.net> writes:
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.
Aug 29 2016
parent reply bachmeier <no spam.net> writes:
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.
Aug 29 2016
parent Suliman <evermind live.ru> writes:
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
Aug 29 2016