New Wiki page to save time in the forums

CraigDillabaugh via Digitalmars-d digitalmars-d at puremagic.com
Thu Jan 29 11:55:11 PST 2015


On Thursday, 29 January 2015 at 18:24:29 UTC, Jonathan Marler
wrote:
> The recent thread about how to solve the problem of odd looking 
> function attributes gave me an idea to have a page that 
> explains why certain decisions were made in the language.  
> Instead of having to write a long thought out response every 
> time someone asks a question who isn't aware of previous 
> discussion, you can respond with a link to the page.
>
> I've created such a page in the wiki!
>
> http://wiki.dlang.org/Language_Designs_Explained
>
> Currently the explanations are in the form of FAQ.  I left one 
> question unanswered since I don't know the answer so I 
> encourage someone who does to check it out and fill it in :)
>
> Since a wiki page is not the same as a forum post, I would like 
> to encourage people who add questions and answers to be as 
> detailed as necessary.  No one wants to read a novel but every 
> detail you leave out will end up making someone come back to 
> the forums to ask about whatever was missing from the page.

Looks nice.  Now that you've started here is some more content
for you :)

http://dlang.org/faq.html

It seems that your efforts, and the existing FAQ (which is dated
and still has a link to the old language comparision page) should
be integrated somehow. It would be nice if eventually D had
something like:

http://www.parashift.com/c++-faq/

Following that example, it might be worthwhile to create a
hierarchy for your design decisions document.  You could have an
entry "What's Up With Function Attributes?", or something similar
and put this page under that heading.  Having a nice hierarchy
will also help folks find what they are looking for.

One issue I have with a Wiki FAQ is that it would be really nice
if any D code appearing on the Wiki could be tested with each
compiler release, to make sure the FAQ and compiler stay in sync.
   I am not really sure how that could be done though. If the
primary purpose is to discuss design decisions then it is likely
not such a big issue I suppose.


More information about the Digitalmars-d mailing list