Thanks for stepping up on this!
On Thu, Dec 13, 2012 at 3:30 AM, Ulrich Stärk <[email protected]> wrote: > FYI: https://issues.apache.org/jira/browse/INFRA-5647 > > On 11.12.2012 20:19, Ulrich Stärk wrote: > > Yes, I want to see something like what you describe as well. Ideally > something that can also > > generate different output formats like PDF and HTML. But we won't have > that by Jan 1. So the > > short-term goal is to take a first step, convert to svnpubsub, but keep > our existing documentation > > sources. > > > > Uli > > > > On 11.12.2012 19:55, Howard Lewis Ship wrote: > >> And what's the point at which the cost of doing this exceeds the cost of > >> switching to a proper tool? I see Confluence as an impediment to > writing > >> documentation; it is very slow, the markup language is poorly thought > out > >> and idiosyncratic, and the publishing mechanism is > >> chewing-gum-and-bailing-wire. > >> > >> I would prefer a tool that treated documentation source as source files, > >> and made it easy to generate documentation in multiple formats, and > easy to > >> adapt to our purposes. I want a tool that lets me be DRY. I want a tool > >> that can access actual Java source code and include it into a page, so > that > >> we can ensure our samples are accurate. > >> > >> I'm on a hunt for such a tool. Our process would then be: check out > >> documentation source, compile it HTML in a SVN workspace, check that > >> workspace in, see it live. > >> > >> On Mon, Dec 10, 2012 at 11:22 PM, Ulrich Stärk <[email protected]> > wrote: > >> > >>> we'll probably copy it over, monitor changes to the original and > >>> incorporate them when we know that > >>> > >> > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [email protected] > > For additional commands, e-mail: [email protected] > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > > -- Howard M. Lewis Ship Creator of Apache Tapestry The source for Tapestry training, mentoring and support. Contact me to learn how I can get you up and productive in Tapestry fast! (971) 678-5210 http://howardlewisship.com
