On 9/13/16, 12:07 AM, "Christofer Dutz" <christofer.d...@c-ware.de> wrote:
>Hi all, > > >How about me turning on the site deployment feature (It's the identical >setup to the one of the Maven project). It would automatically deploy a >sub-directory of "https://flex.apache.org" ... I would suggest >"https://flex.apache.org/flexjs". We could have a look at what it >produces and find a way to add a form-mailer. > > >Would this be acceptable? Seems worth doing so we can see how it will look. I read a bit about GitHub pages and it sounded interesting to me. I wonder if GH Pages would get us more visibility than flex.a.o. GH Pages seems to leverage "orphan" branches so the doc can be in the same repo, but in a different "view" or branch so activity there won't clutter changes to code. Whether we use GH Pages or not, we might want to consider organizing the doc that way. I'm not sure if ASF projects are required to release written doc that is effectively a web site. We don't have "releases" of our web site sources. Gh Pages seems to support AsciiDoc. I read a bit about AsciiDoc and didn't easily get why it would be better than markdown. It just seemed like another flavor of markdown. -Alex