It's not like there's NO documentation, there's better documentation than JavaDocs. The user guide is far more readable and logically structured and searchable. If you read it, you'll see that JavaDocs wouldn't offer much more...
I had time to write it, so you have time to read it. :-) Clinton On Thu, Aug 13, 2009 at 8:42 AM, Fred Janon <fja...@gmail.com> wrote: > I don't like Javadocs either (except Sun's, uh Oracle's), but no one has > come up with something better (apart from literate programming), because > anyway docs == more work (lots of it) and docs == no fun and docs.writer != > programmer. Unfortunately, code without doc means very few people use it and > most of the time I am one of them, I already don't have enough time to do my > work to pay the bills... I wish I had time to have fun looking at all the > code the Open Source Gods gave us :) > > I'll try, I am starting a project and I wouldn't mind dropping H and use > iBatis again. > > Fred > > > On Thu, Aug 13, 2009 at 20:42, Clinton Begin <clinton.be...@gmail.com>wrote: > >> There's no JavaDocs. This is my own personal hangup. I despise Javadocs. >> :-) I've never liked them in code, or reading them online... the only good >> ones are those written by Sun for the JDK IMHO... The thing about iBATIS is >> that the actual Java code is very simple to understand -- you only use about >> 5 classes and they're very simple. The important part to understand about >> ibatis is the SQL mapping and XML. >> >> That said, a couple of our devs do like JavaDocs and will probably add >> them when they find some time. >> >> I would like to get an updated JPetStore example, but I'm out of time >> right now. Perhaps before the first GA release. Or... someone from the >> community can do it. >> >> Clinton >> >> >> On Thu, Aug 13, 2009 at 2:39 AM, Fred Janon <fja...@gmail.com> wrote: >> >>> Are there several "docs"? I can see only the "User' Guide" on the main >>> page. No javadoc? I presume the javadoc link on the main page of the web >>> site is still the one for the previous version? >>> Is there any full example, like a java example? I didn't find any in the >>> download (jar or src). >>> >>> Thanks >>> >>> Fred >>> >>> >>> On Sun, Aug 9, 2009 at 04:33, Clinton Begin <clinton.be...@gmail.com>wrote: >>> >>>> The docs are long, but you can skim them for the new features. That >>>> said, most of our goals were not new features, but improving the >>>> quality and effectiveness of the features that make ibatis what it is. >>>> >>>> Clinton >>>> >>>> On 2009-08-08, Chema <demablo...@gmail.com> wrote: >>>> > Congratulations >>>> > >>>> > Where can we look for the main new features ? I mean, a short list >>>> with the >>>> > news >>>> > >>>> > >>>> > Thanks >>>> > >>>> > >>>> > 2009/8/8 Nathan Maves <nathan.ma...@gmail.com> >>>> > >>>> >> A month ago iBATIS turned 7 years old, and while we're celebrating a >>>> >> little late, today we're happy to announce iBATIS 3 for Java. iBATIS >>>> 3 >>>> >> is a complete rewrite from the ground up and thus represents the >>>> >> biggest change since the very first version of iBATIS released in >>>> >> 2002. There are a lot of modern features that take advantage of Java >>>> >> 5. iBATIS 3 includes simplified design and some great new tools for >>>> >> helping you build great database driven applications. iBATIS 3 >>>> carries >>>> >> forward all of the principles that have made iBATIS popular. There >>>> are >>>> >> still no required 3rd party dependencies, it's simpler than ever, and >>>> >> yet far more powerful! More information will come in the next few >>>> days >>>> >> to help you get started. >>>> >> Introducing the iBATIS Schema Migration System >>>> >> >>>> >> Along with iBATIS 3, we're happy to introduce the iBATIS Schema >>>> >> Migration System (or iBATIS Migrations for short). This powerful tool >>>> >> was inspired by Rails Migrations and similar tools like dbdeploy to >>>> >> enable good database change management practices, help teams to work >>>> >> concurrently without stepping all over each other and avoid having to >>>> >> centralize database changes. Once you work this way, you'll find it >>>> >> very hard to work any other way again. Developers and DBAs will >>>> >> appreciate it equally. >>>> >> >>>> >> You can find the new artifacts including the new jar files and >>>> manuals >>>> >> at the URL below. >>>> >> >>>> >> http://ibatis.apache.org/java.cgi >>>> >> >>>> >> We will send out an email as soon as we get the artifacts out on the >>>> >> Maven repositories. >>>> >> >>>> >> iBatis Team >>>> >> >>>> >> --------------------------------------------------------------------- >>>> >> To unsubscribe, e-mail: user-java-unsubscr...@ibatis.apache.org >>>> >> For additional commands, e-mail: user-java-h...@ibatis.apache.org >>>> >> >>>> >> >>>> > >>>> >>>> -- >>>> Sent from my mobile device >>>> >>>> --------------------------------------------------------------------- >>>> To unsubscribe, e-mail: user-java-unsubscr...@ibatis.apache.org >>>> For additional commands, e-mail: user-java-h...@ibatis.apache.org >>>> >>>> >>> >> >
