I'm not resistant ... I just haven't heard any better alternatives. Here are some criteria (my assumptions) to consider.(I'm going to reserve my right make up some words here ;-)
Developer/Author criteria:Accessible - OOo is free.Easy - OOo is WYSIWYG, familiar word processing paradigm.Portable -
Let's look at how much fun it is to do XML examples with DocBook...programlistinglt;?xml version=1.0 encoding=UTF-8 ?gt;lt;!DOCTYPE sqlMapConfig PUBLIC -//ibatis.apache.org//DTD SQL Map Config
2.0//EN http://ibatis.apache.org/dtd/sql-map-config-2.dtdgt;lt;!-- Always ensure to use the correct XML
Oh, come on now...who edits the XML by hand?
Let's look at it if you are using somthing like XMLMind's (free) XXE:
Edit Insert After... programlisting (paste sample code)
No, it's not mother-in-law simple, but we're all pretty technical
people or we'd be using Access to develop applications
On 9/21/06, Clinton Begin [EMAIL PROTECTED] wrote:
I'm not resistant ... I just haven't heard any better alternatives.
..and I am not so crazy about DocBook either, just wanting to explore it more.
Developer/Author criteria:
Accessible - OOo is free.
So is XMLMind's XXE.
Easy - OOo is
Wow I just asked about section numbers and now you guys are all
salivating about docbook. Fine with me as long as some day the
section numbers appear in the Java version of the docs ;=)
How about a wiki that stores everything in docbook format ?
See
http://doc-book.sourceforge.net/homepage/
Dude, I seriously can't believe the section numbers are so important to you. I've never noticed section numbers in anything I've read. Cest la vie. ;-)In any case, we shouldn't confuse the tools and formats with content. Obviously any of the aforementioned approaches can include section numbers.
Haha, what are you saying?
[EMAIL PROTECTED] ~/projects/ibatis/trunk/rb $ ls docs/
total 0
drwxr-xr-x 3 users 72 Aug 9 09:58 .
drwxr-xr-x 6 users 152 Aug 9 09:58 ..
drwxr-xr-x 7 users 328 Aug 9 10:00 .svn
There are *no* ruby docs. :)
Larry
On 9/21/06, Clinton Begin [EMAIL PROTECTED]
I seriously can't believe the section numbers are so important to you.
Of course not. I wouldn't have cared about numbering except that
while I found the content of the devguide very good I had difficulty
navigating it. I wanted to jump in to something like complex
mapping but I found it
Why haven't *you* added the section numbers?
Typical answer of an opensource geek. Sheesh I suddenly feel an urge
to write this friggin JDBC by hand after all. OK, if IBATIS works for
me I'll do the doc ;=) Just don't hold your breath - my wife and baby
need some love and attention too.
Now
Don't get us wrong Richard, we're not on your case. Your points are all valid, and we want to take them seriously. I want a solution that: Improves the quality of our documentationImproves the timeliness of our documentation
Improves community involvement my wife and baby need some love and
...This story has some interesting parallels to the Open Source Software community...The Story of Little Red Hen
==Once there was a Little Red Hen who lived in a barnyard with her three chicks and a duck, a pig and a cat.One day the Little Red Hen found some grains of
Abator generated Java classes with Special character
Key: IBATIS-348
URL: http://issues.apache.org/jira/browse/IBATIS-348
Project: iBatis for Java
Issue Type: Improvement
12 matches
Mail list logo