I just checked in the Ant task to generate the docs from Wiki. As we
want to keep record of the docs version, and also since doc
generation is a fairly expensive operation, I checked in the output
to SVN under cayenne-other/wiki-docs.
To refresh the docs, run "ant doc" and commit the results. The beauty
of it is that such procedure only checks in the changes made since
last check in (so if Wiki hasn't changed, SVN won't change either).
This way we can have real docs versioning. Of course a change in the
Velocity template would result in all pages being updated, but this
doesn't concern me at all.
TODOs:
* Do we have chapter ordering working?
* Link generated pages to the local JavaDocs, not the docs on the site.
* Should we move the content of "Documentation" folder one level up,
so that it is at the same level as JavaDocs and other doc-related
stuff in the release bundle? Cris, what do you think?
Andrus
On Apr 17, 2006, at 9:38 PM, Cris Daniluk wrote:
> I just checked in the code to generate the docs. I have not tied in
> the ant
> task yet, as it does add considerable weight to the build time -
> about 2
> minutes on my high speed connection. Basically, it would run
> something like
> this:
>
> <docgen spaceKey="CAYDOC" docBase="${doc.base}"
> startPage="Documentation" username="${confluenceUser.username}"
> password="${
> confluenceUser.password}" />
> <copy todir="${doc.base}">
> <fileset dir="../cayenne-other/docs">
> <include name="**/*"/>
> </fileset>
> </copy>
>
>
> This will include the CSS and supporting images. The rest is fed
> through a
> velocity template, and the content is pulled via the SOAP API. All
> attachments (aka images) are pulled locally and included in the doc
> bundle,
> which seems to weigh in at around 2mb, not much larger than the old
> docs
> when you consider what we've added in terms of new content. Note
> that a
> confluence user/pass is required.
>
> I THINK the generated content is now correct. I've tested all the
> links,
> etc. Feedback on this is definitely appreciated! Hopefully we can
> have this
> all in place for the first milestone.
>
> Cris
This archive was generated by hypermail 2.0.0 : Tue May 09 2006 - 21:48:37 EDT