I thought I'd never say this but... Fabio was indeed polite and his question
was very reasonable.
FB
> I'm asking too.
> I don't understand which kind of documentation gwapo1000 is looking for.
>
> Oskar, which is your problem ? why my questions are not polite ?
> I'm asking to gwapo1000, perhaps he can send us a link, an example or a
more
> clear explication of the documentation he is looking for.
>
> I have personally wrote some docs, and I have personally re-designed some
> diagram as I'm personally deployed the API-docs using SandCastle. There
are
> some users helping us with the improvement of documentation (the last one
> was Diego Mijelshon) creating issues and providing proposals. Instead
waste
> your time defining what is polite and what is not polite perhaps you,
Oskar,
> may do something.
>
>
> On Tue, Sep 28, 2010 at 4:05 PM, Oskar Berggren <[email protected]>
> wrote:
>
>
> Please Fabio, he was only asking politely. It seems unreasonable to
> demand proof that some other OSS project have documented their
> internals before you are allowed to ask if such information happens
> to
> exist for this project. Surely the usefulness of such documentation
> doesn't depend on some random other project having that kind of
> documentation?
>
> Reading source code is useful, and must ultimately be done to gain
> full understanding, but having a high-level map of the forest of
> details isn't worthless. IMHO.
>
> /Oskar
>
> Ps. I'm not suggesting that someone unpaid _must_ write such docs,
> unless they want to.
>
>
> 2010/9/28 Fabio Maulo <[email protected]>:
>
> > For example ?
> > Have you an example of the documentation you are looking for with
a
> link to
> > those docs of another OSS project without a big business-monster
> behind it ?
> >
> > On Tue, Sep 28, 2010 at 2:05 PM, gwp <[email protected]> wrote:
> >>
> >> Hi, i would like to learn nhibernate internals, and therefore im
> >> trying to find some documentation for nhibernate source code.
Most
> >> class contatin only briefly description, i would like see for
> example
> >> some diagram, some pattern usage , more technical infrormation.Of
> >> course i can read source code, but without proper information its
> very
> >> difficult task. If anyone know if such docs exists? or
> documentation
> >> is only in source code and mailing list?
> >>
> >> thanks in advance.
> >
> >
> > --
> > Fabio Maulo
> >
> >
>
>
>
>
>
> --
> Fabio Maulo
>
