Glenn,
From: "Glenn McAllister" <glenn@somanetworks.com>
>
> I think we all agreed last release that we needed something better, like
> Anakia or stylebook or whatever. The stopper was we wanted to have
pluggable,
> per task docs that came from their pluggin jars (a la Ant 2).
Still a good idea.
>
> Seeing as something like this was I wanted for the 1.2 release, I'm
certainly
> not going to object. :-) My only comment is that you probably do want to
> break out the optional task docs as well. With them still living in the
main
> index.html, its a little confusing as to why you don't get bumped out the
same
> way you do with the core tasks.
Yep, absolutely. There are these issues and a number of things that would
need to be fixed: task to task links, links to other parts of the old
index.html, etc. This was just a proof of concept thing. I didn't want to
put in more effort than was necessary to show the idea.
The documentation file per task feels right.
> Also, you need a link back from the index of
> tasks to the main page (or one on each content page, but thats harder to
> maintain).
>
OK, good idea.
Conor
|