On Sun, 14 Dec 2014 18:37:26 +1000
Manu via Digitalmars-d <digitalmars-d@puremagic.com> wrote:

> docs, even if they don't really know the language, after all, "what is the point of documentation if not to teach the language..."
i think that something is *VERY* wrong with them. for teaching the language we have textbooks, and documentation is for those who already knows the language.

each time i see the documentation that wants to teach me basics i crying and my eyes are bleeding. i immediately want to commit a homicide.


but i understand your reasoning here, albeit it has nothing in common with mine.

On 14/12/14 09:37, Manu via Digitalmars-d wrote:
> The formatting  didn't help, there's a lot of noise and a lack of
> structure in the documentation's presentation that makes it hard to
> see the information through the layout and noise. As senior software
> engineers, they basically expected that they should be able to read
> and understand the docs, even if they don't really know the language,
> after all, "what is the point of documentation if not to teach the
> language..."

Can you be a bit more precise about what were the stumbling blocks with the documentation?  Were there any particular concepts necessary to understand the docs that weren't there?  What were the exact things they were trying to do (in terms of accessing and understanding the documentation) that were difficult? Did they give any particular feedback in terms of how they expected things to be organized, and how that differed from what they found?

Thank you in any case for trying to get people on board.  I'm sorry it was such a negative experience for you all.