> Whoooooaaaaaaoooo: > > One of the great attributes of iBatis is its documentation. > > I have seen commercial products that do not measure to the well organized > and detailed documentation ofiBatis an Open Source based product.
I appreciate the current condition of the documentation as being a open source project, but it should be better. > For the authors and for us users of iBatis, it will be beneficial for you > to > clarify: > > 1. Organization of the material. How is it that you perceive the > available material as disorganized? For example, on page 27, a Category - Product example is given for Complex Collection Properties. On the next page the iBatis solution is given with a different example. I'd like to see the same example enhanced (ofcourse the primary example could be a more complex one to demonstrate the benefit). For example, I'd like to see a more pure JDBC Compared approach (at least a few examples) for showing the iBatis value. I cannot catch the big picture really (may be because of not being a native English speaker). And lastly I'd like to see the document in HTML with a more beautiful and better layout :) > 2. Undocumented features. What features are you trying to use for > which information is unavailable. http://opensource.atlassian.com/confluence/oss/display/IBATIS/Not+Yet+Documented and 2.1.0 features. Lastly as being an Apache Project, I think, the documentation needs at least some informational changes to reflect the current state. Thanks. -- Ersin > jfz. > > On 6/6/05, Ersin Er <[EMAIL PROTECTED]> wrote: >> >> > is there a reason for a major update to the ibatis sql mapper >> > documentation? >> >> I think yes. It seems to be unorganized and there are undocumented >> features, to me.. >> >> -- >> Ersin >> >> >> > On 6/6/05, Ersin Er <[EMAIL PROTECTED]> wrote: >> >> Hi, >> >> >> >> Is there any plan for a major update for iBatis SQL Mapper >> >> documentation? >> >> >> >> Thanks. >> >> >> >> -- >> >> Ersin Er >> >> >> > >> >> >