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? Chris ________________________________ Von: Alex Harui <aha...@adobe.com> Gesendet: Montag, 12. September 2016 17:12:07 An: dev@flex.apache.org Betreff: Re: AW: AW: [FlexJS] Starting with the Docs Ideally, a comment tool would send an email to dev@. This isn't the first time some expressed a "like" for doc comments. I'm not saying we have to have it, but it would be nice if it was possible for some volunteer to make it happen. Maybe our doc system will eventually be a FlexJS app anyway. It might need some really good filtering, up-voting/down-voting for different variants of components, etc. -Alex On 9/11/16, 10:43 AM, "Christofer Dutz" <christofer.d...@c-ware.de> wrote: >“Form mailer“. ... Stupid mobile Phone auto correction ;-( > > > >Von meinem Samsung Galaxy Smartphone gesendet. > > >-------- Ursprüngliche Nachricht -------- >Von: Christofer Dutz <christofer.d...@c-ware.de> >Datum: 11.09.16 19:33 (GMT+01:00) >An: dev@flex.apache.org >Betreff: AW: AW: [FlexJS] Starting with the Docs > >Well I think most projects don't have comment on features in their >documentation sites. So fire me this wouldn't be a killer criteria. >Especially because it would require us to monitor these comments too. >It's getting more and more places we should monitor for questions, so I >would prefer people having problems with the documentation to post on our >lists. Eventually embedding a firm maker on the documentation would be an >option. > >Chris > > > >Von meinem Samsung Galaxy Smartphone gesendet. > > >-------- Ursprüngliche Nachricht -------- >Von: Alex Harui <aha...@adobe.com> >Datum: 11.09.16 07:16 (GMT+01:00) >An: dev@flex.apache.org >Betreff: Re: AW: [FlexJS] Starting with the Docs > > > >On 9/10/16, 2:36 AM, "Christofer Dutz" <christofer.d...@c-ware.de> wrote: > >>Hi Alex, >> >> >>actually that's not quite true. We have the Wiki and the Website. The >>problem is that usually changing the website is far more work than to >>edit the wiki. The thing with the Maven Site generation however is that >>it automatically generates the entire Project documentation AND >>automatically updates the content in Subversion. All is prepared to start >>doing this, but I disabled the final upload of the generated site as we >>haven't discussed that yet and I didn't want to do it without. Even if >>linking to ASDoc on the Flex Buildserver works, the server isn't really >>great from a performance point of view. Having the documentation on the >>main Apache Webservers would definitely be nicer. >> >> >>Have you guys had a look at the links I provided? The cool thing with >>them is that they are absolutely standard and anyone will know where to >>look for what information. Every maven-based projects has the same. > >I haven't looked closely myself because I don't have any objection to >using something different. I'm slowly trying to build consensus to build >on not just what "technology" to use, but also how to use it. I'm not >sure how to get comments on the website pages, so I'd be tempted to host >FlexJS doc elsewhere, like in a new repo for Tour de FlexJS. Looks like >there are comment plugins for GH pages. The wiki is just what we have >for now. I don't expect we'll use it forever. > >-Alex >
