Re: Do we need a FAQ page?

2016-08-29 Thread Suliman via Digitalmars-d
I already wrote one alternative version. Dlang.ru is down, but on 
page there is germany translation version 
http://forum.dlang.org/thread/vxmieatguqfkwgzli...@forum.dlang.org


Re: Do we need a FAQ page?

2016-08-29 Thread bachmeier via Digitalmars-d

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.


Re: Do we need a FAQ page?

2016-08-29 Thread bachmeier via Digitalmars-d

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.


Re: Do we need a FAQ page?

2016-08-29 Thread Seb via Digitalmars-d

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


Re: Do we need a FAQ page?

2016-08-29 Thread bachmeier via Digitalmars-d

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.


Re: Do we need a FAQ page?

2016-08-29 Thread Cauterite via Digitalmars-d

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.


Re: Do we need a FAQ page?

2016-08-29 Thread jmh530 via Digitalmars-d

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


Re: Do we need a FAQ page?

2016-08-29 Thread Andrea Fontana via Digitalmars-d

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.


Do we need a FAQ page?

2016-08-29 Thread Andrea Fontana via Digitalmars-d
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