Not sure.. Michael's had a busy week and he's had ideas on this one for a while. Mike?
On 2/7/13 10:31 AM, "Marcel Kinard" <cmarc...@gmail.com> wrote: >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 >>>>>>>>> >>>>>>>> >>>>>>> >>>>>> >>>>> >>>> >>>> >>> >
