Poking this thread with the release of 2.4. Where are we at?
Is there anything I can do to help? -- Marcel Kinard On Jan 17, 2013, at 12:19 PM, Michael Brooks <mich...@michaelbrooks.ca> 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 > > > 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 >>>>>>>> >>>>>>> >>>>>> >>>>> >>>> >>> >>> >>
