> > Yay! Board Report another objective complete!
Or better said: Yay! Another board report objective complete! On Tue, Feb 19, 2013 at 4:56 PM, Michael Brooks <mich...@michaelbrooks.ca>wrote: > Yay! Board Report another objective complete! > > > On Tue, Feb 19, 2013 at 4:54 PM, Brian LeRoux <b...@brian.io> wrote: > >> Sweet. I'll update the board report. =) >> >> On Tue, Feb 19, 2013 at 4:38 PM, Michael Brooks <mich...@michaelbrooks.ca >> >wrote: >> >> > Update: Short-term goal [1] is now complete. >> > >> > The documentation is hosted on Apache infrastructure under the Apache >> > Cordova website. Additionally, http://docs.cordova.io/ redirects to the >> > Apache Cordova documentation. >> > >> > [1]: https://issues.apache.org/jira/browse/CB-1880 >> > >> > On Thu, Feb 7, 2013 at 4:00 PM, Michael Brooks < >> mich...@michaelbrooks.ca >> > >wrote: >> > >> > > Steve Gill and myself sat down on Friday and reviewed the state of the >> > > documentation and where we need it to go. >> > > >> > > The short-term goal is to host the documentation on >> > > http://cordova.apache.org/docs and redirect with >> http://docs.cordova.io >> > > >> > > The long-term goal is everything else - theming, organization, >> document >> > > structure, etc. I don't want this discussion to happen on this thread. >> > > >> > > The short-term goal is small and focused. No automation for updating >> or >> > > anything like that. It's meant to achieve our objective on the Apache >> > board >> > > report and set a new objective. After hosting the documentation, we >> will >> > > need to cull the versions down to only those that are part of Apache >> > > Cordova (removing the old PhoneGap versions). We can look into an >> > > auto-update mechanism, although the generator will be replaced in the >> > > long-term goal. >> > > >> > > A downside to hosting the documentation on the website's SVN is that >> it >> > > will shoot up to roughly 600MB (300MB in public/ and 300MB in www/). >> We >> > can >> > > reduce this by removing the irrelevant versions. >> > > >> > > As Fil mentioned, this week has been busy. Before starting work, I'll >> > > create and update the relevant JIRA issues, then open a discussion on >> > where >> > > we want the docs to go. >> > > >> > > Michael >> > > >> > > On Thu, Feb 7, 2013 at 12:47 PM, Filip Maj <f...@adobe.com> wrote: >> > > >> > >> 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 >> > >> >>>>>>>>> >> > >> >>>>>>>> >> > >> >>>>>>> >> > >> >>>>>> >> > >> >>>>> >> > >> >>>> >> > >> >>>> >> > >> >>> >> > >> > >> > >> >> > >> >> > > >> > >> > >