This isn't exactly a feature of the new documentation, but any chance of
keeping up a copy of the documentation as of NHibernate 2.1 on NHForge for a
few months with a clear link to the 2.1 documentation from the top of the
3.0 version, and very clearly, very obviously marking the version number on
both? Of course, NH 2.1 is no longer supported, but it will take a while to
for people to get their projects updated to the new version of NHibernate,
and once the single linked version of the documentation gets bumped, it gets
a tougher to find documentation that is accurate for the prior version ("why
isn't this QueryOver feature working? it's not supported in 2.1? oh, I
should have noticed that tiny 3.0 at the top... oops. so where's the 2.1
docs then?").. I suppose making it harder to find 2.1 documentation is
encouragement to move to 3.0, but there are probably more user-friendly
forms of encouragement, and keeping up an older version wouldn't require
much upfront or ongoing work. Yes, there is version-specific documentation
bundled in the source, but that's probably not the go-to location for
reference documentation that most people are using.
On Mon, Oct 25, 2010 at 9:25 AM, Mario Dal Lago <[email protected]>wrote:
> include the new features of nh3 , Query, QueryOver, etc.
>
>
> *
> Mario Dal Lago*
>
>
> --- El *lun 25-oct-10, Fabio Maulo <[email protected]>* escribió:
>
>
> De: Fabio Maulo <[email protected]>
> Asunto: [nhusers] What you would like to have in our reference
> documentation
> Para: "nhusers" <[email protected]>
> Fecha: lunes, 25 de octubre de 2010, 10:35
>
>
> Consider this thread as a poll to know what you would like to have in our
> reference documentation.
> We know that we have some obsolete info, some incomplete info and a lot of
> info spanned in various blog posts.
>
> What you would like to have in our reference documentation ?
>
> more images ?
> step by step example about some general mapping task ?
> specific "How to" ? about what ?
> more details about extensions points ? which one ?
> ....
> ....
> ....
>
> Please collaborate with some ideas and will try to find a solution.
> We will use this thread to find better ideas and apply it.
>
> Thanks.
> --
> Fabio Maulo
>
> P.S. try to avoid to transform this thread in personal discussion, each one
> has an opinion and opinions, in this case ( ;-) ), are welcome.
>
> --
> You received this message because you are subscribed to the Google Groups
> "nhusers" group.
> To post to this group, send email to [email protected].
> To unsubscribe from this group, send email to
> [email protected]<nhusers%[email protected]>
> .
> For more options, visit this group at
> http://groups.google.com/group/nhusers?hl=en.
>
>
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "nhusers" group.
> To post to this group, send email to [email protected].
> To unsubscribe from this group, send email to
> [email protected]<nhusers%[email protected]>
> .
> For more options, visit this group at
> http://groups.google.com/group/nhusers?hl=en.
>
--
You received this message because you are subscribed to the Google Groups
"nhusers" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/nhusers?hl=en.
