mesos-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From haosdent <haosd...@gmail.com>
Subject Re: Website update frequency
Date Wed, 11 Nov 2015 02:43:51 GMT
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 <jono@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 <vinodkone@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 <adam@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 <jono@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.conway@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

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message