Example within documentations of D seriously need some improvement.

[Jacob Carlborg]

On 2011-05-27 16:18, Matthew Ong wrote:
> On 5/27/2011 9:16 PM, dennis luehring wrote:
>
>> better and better --> YES - your talking mostly to sparetime developers
>> here
> I have some sense that is the case here because of different email
> domain from so many different coder. No wonder there does not seem to be
> properly organized. There is limited coherent among the document.
>
>> all you can do - show us the problems, get to the point that everything
>> is still growing,
> That is not intentional document improvment. It sounded like ad-hoc
> mutations to me.
> Please review how others has done the organization using the 3 links I
> posted. Get the some solid points on how those 3 are better at the top
> level. Before the next change took place within D.
>
> Format of the documentation needs to be defined properly to make
> navigation and expectations easy.
>
>  >that YOU can start imeditately by bringing in new/changed content -
> would be great
> It is too early for me to do that as I am just 3 week in D.

Maybe that's what just we need. Someone with almost no experience in D 
can look at the documentation with fresh eyes and better see what needs 
to be change to make it easier for people new to D.

-- 
/Jacob Carlborg