On Oct 6, 2013, at 3:13 AM, Mirko Friedenhagen <[email protected]> wrote:
> Hello there, > > just my 2 cents: > > * I do not understand what is that bad about xdoc which is almost HTML. And > having a XSD/DTD code completion is available. > It's not bad, per se. It's really about the prevalence of good editors. I don't much find the XSD/DTD of much benefit in contrast to editors like Mou where I have the raw content on the left, rendered content on the right, I can edit diagrams, reload and iterate. > * *All* freestyle markup languages are ugly and hard to remember (I have to > use TWiki/FosWiki and JIRA inhouse) > > * So getting rid of APT looks like a good idea but to be consistent with > Wiki/JIRA of Maven I could imagine Confluence to be a better choice. > > Regards Mirko > -- > Sent from my mobile > On Oct 6, 2013 5:31 AM, "Jason van Zyl" <[email protected]> wrote: > >> 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 >> --------------------------------------------------------- >> >> >> >> >> >> >> >> Thanks, Jason ---------------------------------------------------------- Jason van Zyl Founder, Apache Maven http://twitter.com/jvanzyl ---------------------------------------------------------
