Tried to push current state/idea to avoid you to have to build it locally: http://home.apache.org/~rmannibucau/tomeeng/#
Romain Manni-Bucau @rmannibucau | Blog | Github | LinkedIn | Tomitriber 2016-03-17 11:57 GMT+01:00 Robert Panzer <[email protected]>: > Hi, > > even though not a committer I’d like to give my 2 cents on this: > > Regarding a GH* based workflow: > > Having provided some updates to the documentation recently I think the > current process does not really promote contributions and collaboration. > For example I did not get any notification from the CMS that my proposal was > received and in fact it wasn’t received and I had to attach svn patches to > Jira tickets. > Nor is there any possibility for review and discussion afterwards. > > So I am strongly for a Github Pull Request-alike workflow, where everyone can > actively search and discuss contributions. > Ideally this workflow should be lightweight enough that you could propose an > update to the documentation after as a user you discovered something that is > not yet documented. > As a supporter it would make sense to update the documentation when you > answered a question that was not obvious just by pasting the interesting > parts out of your email response. > Most often this is the best documentation: To the point and it solves a > concrete problem. > > > Regarding a JBake based solution: > > The current documentation is completely based on Markdown, which makes it > kind of a lottery how the final output will look like. > The update I proposed looked completely different on my machine than finally > on the website, spaces were added to code snippets where they don’t belong, > links get sometimes rendered propery, sometimes not. > Being a member of the AsciidoctorJ developers I certainly appreciate having > support for Asciidoctor via JBake as well. > JBake still supports Markdown and plain HTML as well. > > Cheers > Robert > > > * Don’t nail it down to Github, could be something else that provides a > similar workflow. > > > Am 16.03.2016 um 19:56 schrieb Romain Manni-Bucau <[email protected]>: >> >> Hi guys, >> >> trying to work on the website ATM, created a placeholder project on my >> github to share the idea: https://github.com/rmannibucau/site-tomee-ng >> (mvn jbake:inline then go on http://localhost:8080). >> >> Idea is: >> >> - get a more modern website >> - restructure the doc to be more hierarchic and browsable >> - get rid of the outdated doc >> - make it easier to PR on github >> >> If encouraged I would like to still use the CMS as storing/publishing >> solution but not generation (the edit feature is broken and not that >> user friendly when you are not a committer and when you are you don't >> really need). >> >> wdyt? >> >> Romain Manni-Bucau >> @rmannibucau | Blog | Github | LinkedIn | Tomitriber >
