I think the documentation on the wiki is definitely a big step forward
as it currently stands. We're working on fleshing it out, believe me. We
really need to get this release out though as a people need a solid
basis to build on and to write documentation about.
What I was referring to was the more technical issue of distributing it.
I'd really like to automate the distribution of it so we can pull it out
of the wiki as part of the build. However, I think I can tackle that as
part of the next release. I've done it before, but confluence exports
are a PITA and then there is the issue of getting things formatted
correctly as well.
Dan
Chiradip Narayan Mandal wrote:
Hi Guys,
Of course you are the ones going to make the decisions about what to include
and what not to as you are the guys working very hard on this. But my
personal view is that - documentation is important, I personally faced
problems many a times due to the insufficiency of the documents. If you
touch a milestone - for this case, the 0.4 release - everybody might be a
bit slower for producing the documentation and the excitement of a new
release won't be there. Personally I think with this release there should be
a complete documentation including user guide, developers' guide,
introduction, guide for working on different areas like server, collection
adapters, providers etc..
Regards,
Chiradip
On Tue, Mar 18, 2008 at 10:09 PM, Dan Diephouse <
[EMAIL PROTECTED]> wrote:
James M Snell wrote:
Just a couple of things...
1. Wrong version in the org.apache.abdera.util.Version class...
expected "v0.4.0-incubating" was "v0.4.0-incubating-SNAPSHOT"
We can add a filter so this gets done automatically by the build.
4. We really really really need to work on the documentation for the
next release.
How about we just leave the docs out for this release and just
distribute the apidocs. We can add a link pointing to the website and
make a PDF export of the website available for people to download. Once
we get the docs sorted out a little bit more we can include them in the
distribution.
5. We need to point out somewhere that the JDK 1.4.2 build is not
included in the distribution. If folks want the 1.4.2 jars, they will
need to build from source. With the Ant build, that's fairly simple.
I'm not sure how to do it with the Maven build.
We can add in the retroweaver plugin, but I'm not sure its something we
really want to distribute/support by default right now.
Dan
--
Dan Diephouse
MuleSource
http://mulesource.com | http://netzooid.com
--
Dan Diephouse
MuleSource
http://mulesource.com | http://netzooid.com
