On Fri, Dec 16, 2016 at 12:13 PM, Alex Harui <aha...@adobe.com> wrote:
> > > On 12/16/16, 11:58 AM, "omup...@gmail.com on behalf of OmPrakash > Muppirala" <omup...@gmail.com on behalf of bigosma...@gmail.com> wrote: > > >On Fri, Dec 16, 2016 at 11:54 AM, Alex Harui <aha...@adobe.com> wrote: > > > >> > >> > >> On 12/16/16, 11:42 AM, "omup...@gmail.com on behalf of OmPrakash > >> Muppirala" <omup...@gmail.com on behalf of bigosma...@gmail.com> wrote: > >> > >> >I think we don't need to decide one way or the other right now. We > >>need > >> >simple html docs for sure. > >> > >> I'm not sure what you mean by this. What does "simple html" mean and > >>why > >> do we need it? > >> > > > >I could be wrong, but I assume IDE's need HTML formatted docs to show > >hover > >over API documentation? We cant expect a JS engine being available > >everywhere. > > If you are referring to Flash Builder, I don't know for sure, but there is > some indication that it just needs the DITA.xml file and not html. I > don't know about other IDEs. Josh, have you thought about this for VSCode? > > > > >Also, for SEO we need pre-formatted HTML whichever way you decide to do > >it. > > Are you sure about this? I was under the impression that all RIAs, > whether written in Flex or not, had to simply return HTML for some URL. The file didn't actually have to exist statically. IMO, this problem > needs to be made easy for all FlexJS applications and that's one reason to > make ASDoc a RIA. So we can show folks how to do it. Are there really > static pages behind Home Depot and Amazon's stores? > But then you need something like phantom.js that runs our SPA, renders the html and stores/serves it on demand. When a search bot hits the server, we need to figure that out and redirect it to the phantom.js server instead of serving up the JS and CSS filese required to render the web application. Here is an overview of one way of adding search engine optimization for a single page app [1] My point is: it is quite a bit of unnecessary work when you can simply generate html from asdocs using XSLT. Google can probably just handle a SPA without any special work needed from us [1], but not sure about other search engines. [1] https://lawsonry.com/2014/05/diy-angularjs-seo-with-phantomjs-the-easy-way/ [2] https://webmasters.googleblog.com/2014/05/understanding-web-pages-better.html > > -Alex > > >
