Just a follow up, there is at least one well known Java Project using
Sphinx for documentation: Selenium, also Spock is using it, though they're
not building their docs as part of a CI job. A large list of projects using
Sphinx is also available at [1].
The Selenium pom [2] uses antrun to call
On Fri, Dec 23, 2011 at 15:20, Gerhard Petracek
gerhard.petra...@gmail.comwrote:
i said: if there are too many open questions right now,...
Understood.
-Dan
--
Dan Allen
Principal Software Engineer, Red Hat | Author of Seam in Action
Registered Linux User #231597
to be good, then we can just push
this branch to ds.asf:master
wdyt?
LieGrue,
strub
- Original Message -
From: Gerhard Petracek gerhard.petra...@gmail.com
To: deltaspike-dev@incubator.apache.org
Cc:
Sent: Friday, December 23, 2011 9:20 PM
Subject: Re: [jira] [Created] (DELTASPIKE-13
: Friday, December 23, 2011 9:20 PM
Subject: Re: [jira] [Created] (DELTASPIKE-13) Choose documentation
format and tools
hi dan,
i said: if there are too many open questions right now,...
we already discussed that we would use as few docbook-tags as possible
(in
any case).
however
Btw, I do *strongly* recommend using awestruct for creating the website. In
10+ years of creating websites (and applications) I've never encountered
anything remotely as productive...esp when all you want to do is create web
pages with information.
-Dan
On Fri, Dec 23, 2011 at 18:25, Dan Allen
On Fri, Dec 23, 2011 at 15:32, Mark Struberg strub...@yahoo.de wrote:
Dan, I also like the results Andrew and Aslak had with that for the new
Arquillian page.
...that was mostly done by me, Aslak and Sarah :)
I think we are talking about two different things. For Arquillian, we have
used
There's this: https://github.com/tomdz/sphinx-maven
If not, I'm sure we can write our own. If we with Sphinx then the question is
CPython or Jython for running it. It also looks like there's an ant task wen
you go the Jython route.
Markdown would be fine, but what would you use to create
Shane's probably tired of hearing me harp on docbook, oh well :)
Here's a tool that's nice to use, output is good and it has a great
community following: http://sphinx.pocoo.org/ If we want to look into it,
great, if we go back to docbook, great, I'll stop complaining and just use
it.
Buildable