2013/9/3 Steven Benitez <steven.beni...@gmail.com>:
> I'm not sure that this would be a good fit for Struts2, but I'll throw the
> idea out there anyway.
>
> On my current project, we needed a way to have an internal documentation
> site and I am using Jekyll, Github's open source content generator (the
> same engine that powers Github Pages). The actual documentation are stored
> as markdown files in Git (could be in the S2 repository).
>
> http://jekyllrb.com/

Good idea and we were talking about that - but first we must export
all the docs from Confluence to markdown format, setup comments engine
and so on - lot of work :-) But definitely is worth to engage as the
current ApacheCMS/SvnPubSub mechanism is a bit painful when used with
Confluence ;-) And thus allows contribute patches to documentation :-)

Anyway, before we can start, docs must contain all the data - not to
be spread throughout the source code (example snippets, tag reference)

> A wiki may be better for our purposes, but I think that the barrier to
> contribution needs to be re-worked. I've submitted patches to the code
> before, but to contribute documentation I need to fill out a form, print
> it, scan it, and email/fax it to Apache. Seems like more trouble than it's
> worth, IMO.

C'mon, it's just 5 sec! And opens doors to become committer :-)


Regards
-- 
Ɓukasz
+ 48 606 323 122 http://www.lenart.org.pl/

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@struts.apache.org
For additional commands, e-mail: dev-h...@struts.apache.org

Reply via email to