On Sep 11, 2016 10:44 AM, "Christofer Dutz" <[email protected]> wrote: > > “Form mailer“. ... Stupid mobile Phone auto correction ;-(
Haha, I just read it and was about to google for 'firm maker for docs' :-D > > > > Von meinem Samsung Galaxy Smartphone gesendet. > > > -------- Ursprüngliche Nachricht -------- > Von: Christofer Dutz <[email protected]> > Datum: 11.09.16 19:33 (GMT+01:00) > An: [email protected] > 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 <[email protected]> > Datum: 11.09.16 07:16 (GMT+01:00) > An: [email protected] > Betreff: Re: AW: [FlexJS] Starting with the Docs > > > > On 9/10/16, 2:36 AM, "Christofer Dutz" <[email protected]> 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 >
