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