I'm not saying we tell people not to use it, but for us I don't think it's an issue. It's been years since anything significant has been added to our FAQ and they are few enough that they can be converted by hand to add a TOC. I just want to make working with our documentation a little more enjoyable and amenable to pull requests.
On Oct 5, 2013, at 5:52 PM, Robert Scholte <[email protected]> wrote: > https://jira.codehaus.org/browse/DOXIA-472 ? No, still not fixed. > > IMHO the fml can only be replaced if there's a macro to generate an index of > all the questions. > > Robert > > Op Sat, 05 Oct 2013 22:59:42 +0200 schreef Stephen Connolly > <[email protected]>: > >> Has the page title problem been fixed? >> >> Last I checked you could not set the page title that Doxia generates for >> HTML pages generated from markdown >> >> (Crosses fingers that it is fixed) >> >> On Saturday, 5 October 2013, Jason van Zyl wrote: >> >>> We current have multiple formats for our site documentation and two of >>> them no one else in the world uses except us. We created xdoc here a long >>> time ago in the Jakarta project, and APT has lost in the world of markup. I >>> ported it from another project many years ago but there are many better >>> options like asciidoc, restructured text, and markdown. My preference is >>> for markdown but I would like to get rid of xdoc, fml, and xdoc and convert >>> that documentation over to markdown. The tool support is great for editing, >>> book support is great (the Pro Git book is created from markdown). We can >>> still use all the Doxia tools for all the post processing. But I see no >>> need to 4 different types of markup for the site, and honestly I find >>> working with APT now incredibly annoying. >>> >>> I'm happy to do the conversion and testing. >>> >>> Thanks, >>> >>> Jason >>> >>> ---------------------------------------------------------- >>> Jason van Zyl >>> Founder, Apache Maven >>> http://twitter.com/jvanzyl >>> --------------------------------------------------------- >>> >>> >>> >>> >>> >>> >>> >>> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > Thanks, Jason ---------------------------------------------------------- Jason van Zyl Founder, Apache Maven http://twitter.com/jvanzyl ---------------------------------------------------------
