> > I've got Jenkins running locally, pulling from cordova-docs, polling daily, > and generating the docs. But the SVN Publisher doesn't seem to work: > https://wiki.jenkins-ci.org/display/JENKINS/SVN+Publisher (I tested it on > another SVN repo, not Apache's) -- reports success but nothing is uploaded. > This could be a solution in the interim if I could get the publisher to
Well, it's an interesting experiment. I don't have the time to look into it now, but as I said I'm working to free up February for the documentation update. I'll pick your brain about the Jenkins stuff then. Thanks for looking into it. which by the way, the whole tree right now is over > 300MB. en/edge right now is only 7MB That's not a big concern. The rewrite of the documentation will only version the latest. This will make internationalization contributions more confusing, since most update older version of Apache Cordova, but we can solve that with... documentation. On Wed, Jan 16, 2013 at 10:04 AM, Shazron <shaz...@gmail.com> wrote: > I've got Jenkins running locally, pulling from cordova-docs, polling daily, > and generating the docs. But the SVN Publisher doesn't seem to work: > https://wiki.jenkins-ci.org/display/JENKINS/SVN+Publisher (I tested it on > another SVN repo, not Apache's) -- reports success but nothing is uploaded. > This could be a solution in the interim if I could get the publisher to > actually publish -- which by the way, the whole tree right now is over > 300MB. en/edge right now is only 7MB. > > > On Mon, Jan 14, 2013 at 9:32 AM, Shazron <shaz...@gmail.com> wrote: > > > I agree with Ross that it should be on Apache's servers and not somewhere > > else (like Amazon S3). At most some dev could locally install Jenkins and > > run a CI server with a script that can auto update the SVN repo (using > > their creds), or something - until we can get a permanent solution > > > > > > On Mon, Jan 14, 2013 at 9:22 AM, Michael Brooks < > mich...@michaelbrooks.ca>wrote: > > > >> @Andrew I was thinking S3 so that a service can auto-update on each > >> commit. > >> From Yohei's experience with the cordova.apache.org SVN setup, it looks > >> like automating that is a headache. > >> > >> Michael > >> > >> On Mon, Jan 14, 2013 at 9:16 AM, Andrew Grieve <agri...@chromium.org> > >> wrote: > >> > >> > cordova.io is a bunch of redirects. Do you mean to have > >> > docs.cordova.ioredirect to > >> > cordova.apache.org/docs (or something similar) > >> > > >> > > >> > On Mon, Jan 14, 2013 at 12:13 PM, Michael Brooks > >> > <mich...@michaelbrooks.ca>wrote: > >> > > >> > > Hi Marcel, > >> > > > >> > > I've got this one my roadmap of tasks. > >> > > > >> > > The short-term goal is to have http://docs.cordova.io host our > >> > > documentation and we'll link to it off http://cordova.io. > >> > > > >> > > The longer-term goal is to have the generator and possibly templates > >> > > decoupled from the documentation. At that time, we'll redesign the > >> > > http://docs.cordova.io to use the http://cordova.io site design. > >> > > > >> > > My plan is to start this work on February 1st and have it completed > >> for > >> > the > >> > > next board report. > >> > > > >> > > Michael > >> > > > >> > > On Mon, Jan 14, 2013 at 8:52 AM, Ross Gardler < > >> > rgard...@opendirective.com > >> > > >wrote: > >> > > > >> > > > It not only makes sense I would consider it a priority. Having the > >> only > >> > > > source of docs on a third party website is a no-go as far as I'm > >> > > concerned. > >> > > > I raised this issue during incubation and was assured it was a > >> > > transitional > >> > > > thing. > >> > > > > >> > > > Ross > >> > > > > >> > > > Sent from a mobile device, please excuse mistakes and brevity > >> > > > On 14 Jan 2013 08:44, "Marcel Kinard" <cmarc...@gmail.com> wrote: > >> > > > > >> > > > > Would it make sense to host a copy of the docs on > >> cordova.apache.org > >> > ? > >> > > > > Other Apache projects have their docs online at their > >> apache.orgsite. > >> > > > > > >> > > > > A couple possibilities: > >> > > > > 1) build the html files and zip them up, so a consumer needs to > >> only > >> > > > > download and unzip and point their browser at their local > offline > >> > copy. > >> > > > > 2) build the html files and post them unpacked to > >> > cordova.apache.orgso > >> > > > > they can be browsed directly without a zip or src download. > >> > > > > > >> > > > > My initial suggestion is to do both: something like > >> /docs/download to > >> > > > hold > >> > > > > the zip files and /docs/browse to have the tree starting with > >> > > index.html. > >> > > > > > >> > > > > Or would it be better to host it in www.apache.org/dist/cordova > ? > >> > > > > > >> > > > > I am willing to do the initial setup and load. > >> > > > > > >> > > > > Comments? > >> > > > > > >> > > > > -- Marcel Kinard > >> > > > > > >> > > > > >> > > > >> > > >> > > > > >
