I personally feel there should be a short description of what a method/class does, and a list (or description, but list would be more to-the-point) of conditions the method/class needs.
For example, lately I've been fooling around with the mapping configuration classes, to "manually" configure nhibernate (and fill mappings from code, sort-of-fluentnh), and it took me quite a while to figure out what was necessary. For example (pseudo-names..): method Mapping.AddPersistentClass(PersistentClass) adds a given PersistentClass definition to the mappings. Needs: + valid PersistentClass.Table. + EntityName etc.. I know this mapping area might be considered internal to nhibernate, but this same remark applies to other areas of NHibernate.. Just my 2 cents.. Regards, Matthijs ter Woord On 10/25/10, Fabio Maulo <[email protected]> wrote: > 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]. > 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.
