2017-01-31 18:29 GMT+01:00 Ken McWilliams <ken.mcwilli...@gmail.com>: > Anything that makes document contribution easier is good! > > A traditional wiki in my opinion would be most ideal. Just as it works for > Wikipedia (backed by mediawiki) you'll find that very few people will cause > an issue with documentation. It is also very beneficial if people can > create new pages/links too. All wikis have security to restrict certain > pages to certain users, so security bulletins etc. can be trusted. It is > really nice when you find a spelling error to just fix it then and there. A > wiki I like is Xwiki it's Java based and it happily cooperates with most > any DB. Both these wiki's are _very_ easy to set up. I think Xwiki uses > Struts... I think v2...It is a pretty nice and useful product (FLOSS). > > A plausible option would be to create a wiki and export it's pages into the > main site. Not sure about that sort of flow but for the paranoid it would > allow an official checked version to exist, as well as a faster evolving > version. At the worst move the content with copy and paste.
ASF is using Confluence [1] or MoinMoin Wiki [2] - these are the only options we have ;-) I would like to use git [3] for version-controlling and for easy maintenance and contributions - you don't have to clone a fork locally, you can edit markdown files directly in a browser and create PRs. Also using git allow us to use Jenkins to automatically deploy a new version of website & docs. Right now I'm using this [4] to export all the pages from Confluence and put them inside a website production repo [5] - it's a bit painful and cumbersome process ;-) [1] cwiki.apache.org/confluence/display/WW/ [2] https://wiki.apache.org/general/ [3] https://github.com/apache/struts-site [4] https://github.com/apache/struts-site/blob/master/pom.xml#L27-L46 [5] https://svn.apache.org/repos/infra/websites/production/struts/content/ 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
