Website message overhaul

Peter Alexander peter.alexander.au at gmail.com
Sat Nov 19 06:33:15 PST 2011


On 19/11/11 2:02 PM, Bane wrote:
> I paused with D last year after (yet another) unsuccessful attempt to port my code from D1 to D2. reason: shared stuff. More specific reason - is it a bug with my code or docs ain't exact or that feature isn't working yet (even docs claim it works?)?
>
> So, I guess problem is correctness of manual for D2.  Digging trough this newsletter to find is some feature working and how is terrible way for learning.

I agree with this 100%. It is true that a lot of advertised features in 
D simply do not work at all, and the fact that they don't work isn't 
documented anywhere except in the newsgroups.

In addition to making it incredibly difficult to learn the language, it 
also dissuades people from writing tutorials. A couple of times I have 
started to write tutorials and stopped simply because the stuff I wrote 
didn't actually work (e.g. I'd write about selective imports, but then 
figure out that they don't work as advertised). I don't want to write 
tutorials that are filled with "D is awesome, you can do this... except 
you can't."

Things that don't work simply shouldn't be mentioned in the docs. Put 
them on a "Work in progress" page or something so that people know what 
should be working, but don't advertise them as working features until at 
least one compiler supports them.


More information about the Digitalmars-d mailing list