After a quick google search you are definitely right, I knew google did but they've definitely innovated in the last few years.
Is there any tools to do the same for Doxygen and javadoc? On Wed, Nov 11, 2015 at 1:49 PM, haosdent <haosd...@gmail.com> wrote: > google crawlers support execute javascript. Netty.io looks generate in > server side now. > > On Wed, Nov 11, 2015 at 11:36 AM, Jonathon Rossi <j...@jonorossi.com> > wrote: > > > The JavaDoc on the Netty page looks like static HTML. However I see the > > other docs loading from the wiki. > > > > Loading the Mesos markdown files looks pretty nice and simple using > marked, > > however I assume that'll lock Google Search out of content and change all > > the URLs? > > > > On Wed, Nov 11, 2015 at 12:43 PM, haosdent <haosd...@gmail.com> wrote: > > > > > I think we could consider generate the document realtime. Like > > > http://netty.io/wiki/index.html Loading the markdown from their github > > > wiki > > > repo and generate html in browser. I write some simple javascript to > > > implement this several months ago. > > > http://blog.haosdent.me/mesos/#documentation/latest/home/ > > > > > > On Wed, Nov 11, 2015 at 10:33 AM, Jonathon Rossi <j...@jonorossi.com> > > > wrote: > > > > > > > You are obviously free to implement this as you wish, however one of > > the > > > > things we realised is that the hosted API docs on the web site are > also > > > > very out of date, and by doing it this way would mean they stay out > of > > > > date. Doing it this way means you would really have to update on > every > > > > commit, or at least once a day. > > > > > > > > When we were discussing this with Dave at MesosCon Europe we thought > > the > > > > better option was to have a CI server (or something similar) perform > > this > > > > work by deploying it directly without going via subversion. There are > > > many > > > > other Apache projects with API docs on their web sites so they are > > likely > > > > not going via subversion for this. > > > > > > > > On Wed, Nov 11, 2015 at 4:30 AM, Vinod Kone <vinodk...@gmail.com> > > wrote: > > > > > > > > > That said, this can be automated as a step in apply-reviews script. > > For > > > > > example, the script can check if something in site/ (or docs/ ?) is > > > being > > > > > committed and if yes, also do an svn update. @artem do you want to > > take > > > > > this on as you revamp the apply-reviews script? > > > > > > > > > > On Tue, Nov 10, 2015 at 1:23 AM, Adam Bordelon <a...@mesosphere.io > > > > > > wrote: > > > > > > > > > > > Since it's still a manual process, the website is usually only > > > updated > > > > a) > > > > > > when we have a new release to announce, or b) when some other > > > > blog-worthy > > > > > > content arises (e.g. MesosCon). > > > > > > > > > > > > On Tue, Nov 10, 2015 at 1:06 AM, Jonathon Rossi < > > j...@jonorossi.com> > > > > > > wrote: > > > > > > > > > > > > > It is currently a manual process performed by a committer, > > however > > > > > there > > > > > > > are plans to make it automated. See this thread for the recent > > > > > > discussion: > > > > > > > > > > > > > > http://www.mail-archive.com/dev@mesos.apache.org/msg33541.html > > > > > > > > > > > > > > On Tue, Nov 10, 2015 at 6:56 PM, Neil Conway < > > > neil.con...@gmail.com> > > > > > > > wrote: > > > > > > > > > > > > > > > Does anyone know how frequently the docs at mesos.apache.org > > are > > > > > > > > updated? I notice that some docs changes from > 1 week ago > > aren't > > > > > > > > reflected on the current site. > > > > > > > > > > > > > > > > Neil > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > Jono > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > Jono > > > > > > > > > > > > > > > > -- > > > Best Regards, > > > Haosdent Huang > > > > > > > > > > > -- > > Jono > > > > > > -- > Best Regards, > Haosdent Huang > -- Jono
