Re: [boost] [proto] docs (was: [TypeErasure] Forward constructors and binded types)

Subject: Re: [boost] [proto] docs (was: [TypeErasure] Forward constructors and binded types)
From: Markus Werle (numerical.simulation_at_[hidden])
Date: 2012-07-23 14:43:47

Eric Niebler wrote:

> On 7/22/2012 8:18 AM, Markus Werle wrote:
>> Here I am in the same situation as with proto: I will read the docs again
>> and again and not really get sure about whether I am doing it right.
> 
> <weeps> Proto's pdf docs are nearly 400 pages long! -- not that that
> necessarily means anything. Nevertheless, it's vexing that people still
> find the documentation lacking.

</weeps> I had hoped that I come through with my message that I do not want 
to make you responsible for this or blame anyone. 

> Where are you stumbling? Do you have any concrete suggestions for how I
> could improve things? "Tutorials," isn't a concrete suggestion.
> Something like, "I read X in the docs and didn't understand it," or "I
> am trying to do Y and I can't figure out how," would be more helpful.
> 
> Thanks in advance,

I digged through the docs multiple times but I always get stuck with 
grammars and transforms and callable transforms. Unfortunately I had to 
switch to C# during the day and taking control over proto is not something 
that can be done at midnight. 

I will post questions again in my next attempt to approach proto.

Markus