deltaspike-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dan Allen <>
Subject Re: [jira] [Created] (DELTASPIKE-13) Choose documentation format and tools
Date Fri, 23 Dec 2011 23:25:50 GMT
On Fri, Dec 23, 2011 at 15:32, Mark Struberg <> 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 Awestruct to build out a website which includes a section of tutorials
written in the textile syntax and wrapped in a table of contents and
navigation sidebar.

Sphinx would be used for the reference guide (documenting each feature and
how it's used). We've talked about doing the Arquillian reference guide in
Awestruct too, but for now we think that pure reference should be in a
dedicated reference guide. Like TorqueBox did, it's possible to dump that
into the website, which we may end up doing later.

> Could you probably provide a skeleton and sample integration which we can
> tweak?

We've been talking about creating a stub for other projects to
use, but atm I don't have the bandwidth for creating that archetype. You'd
have to just clone the arquillian site and work from that starting point.

(the content is on the develop branch)


Dan Allen
Principal Software Engineer, Red Hat | Author of Seam in Action
Registered Linux User #231597

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message