[aerogear-dev] [ag.org] Make our doc even dryer

[Corinne Krych]

Hello Guys,

To keep your documentation DRY, Karel suggested the usage of acsciidoc
include in this ML thread [1].

We tried with Erik* some experiment, it's in this gist [2].

I think it's aneat feature and we could use it in different way:

1) reuse some cookbook documentation page (if in asciidoc format)

2) embed source code snippet in our documentation to make sure our doc is
always up to date with latest code

Just wanted to check with you if you like the idea bacause it will involve
some documentation format changes (part of your web site revamp). Note: we
could use code snippet include (option2) without option 1).

wdyt?

++

Corinne

[1]
http://aerogear-dev.1069024.n5.nabble.com/aerogear-dev-Fwd-Website-restructure-td5837.html

[2] https://gist.github.com/anonymous/dac8efdb7c90206acffe

*asciisoc hero
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20140213/0384f0e2/attachment.html