Re: ocamlbuild documentation (was Re: [Caml-list] Re: [ANN] OCaml Batteries Included, alpha 3)

["Daniel Bünzli" <daniel.buenzli@erratique.ch>]

Le 9 févr. 09 à 13:52, Romain Bardou a écrit :

> You don't have to be so mean :(

Sorry.

> Unfortunately, while authors might be the best persons to answer  
> these questions, they are also the ones who do not have any  
> question ;) Finding the right questions is not easy and a Wiki is a  
> nice way to find out.

You need a reasonable base documentation first if you want people to  
try your system. The bare minimum (i.e. the one that doesn't make your  
loose your time with the system) is not here yet. And if you want to  
build things for others to use you better have some empathy, so you  
should be able to imagine some of these questions.

> While I agree that the documentation should answer most questions, I  
> fail to see how "try to look at the wiki" is different from "try to  
> look at the manual".

What I see in the wiki doesn't qualify as a manual to me.

> Do we have to rename "wiki" into "manual in which you can write your  
> own notes" ? :)

The problem is that "wiki" here seems to stand for "write the manual  
for me please".

Daniel