:( We never had full consensus to do this Braden.
On Tuesday, April 9, 2013, Filip Maj wrote: > For a couple months now the npm package has had about 1000 downloads per > month [1]. > > We do have upgrade guides in our docs for each version for each platform. > Maybe we could add a CLI section? Then we can reference those guides in > the CLI's readme? Just thinking out loud. > > [1] http://npmjs.org/package/cordova > > On 4/9/13 5:40 PM, "Braden Shepherdson" <bra...@chromium.org<javascript:;>> > wrote: > > >This mailing list post is, or will shortly be, indexed by Google and > >others. Any newcomers will see the new docs and create new projects. > > > >As I mentioned on IRC, existing users are either accepting or ignoring the > >"alpha" warnings that this software is new and under heavy development, > >and > > if they want to jump on it early they're going to have to expect some > >pain. > > > >That said, I don't really know of any better way to socialize it. Is there > >anywhere where a brief blog post on this would make sense? > > > >I don't know how many people are using these tools and not on the mailing > >list, though certainly some turn up on IRC occasionally. > > > >Braden > > > > > >On Tue, Apr 9, 2013 at 11:24 AM, Filip Maj <f...@adobe.com <javascript:;>> > wrote: > > > >> How will we communicate this change to our existing users? > >> > >> On 4/9/13 5:22 PM, "Braden Shepherdson" <bra...@chromium.org<javascript:;>> > wrote: > >> > >> >I've just pushed a change to the future branch that changes the > >>directory > >> >structure to: > >> > > >> >app/ > >> > merges/ > >> > android/ > >> > ios/ > >> > www/ > >> > config.xml > >> > > >> >As was discussed at our video conference meeting a couple of weeks ago, > >> >this has a number of advantages: > >> >- config.xml is no longer in the www/ directory > >> >- One can easily version control the whole app/ directory, and get > >>their > >> >web assets, merges and so on into the repo. > >> >- That repo can contain additional information: a README.md, > >>supplementary > >> >documentation, tests, whatever. The CLI will ignore anything outside of > >> >the > >> >merges and www directories. > >> > > >> > > >> >The downside is that this is a breaking change: running the new > >>version of > >> >the tools on an old project will fail (but I think in a harmless way) > >> >until > >> >you rearrange the directories. You can do that with the following > >> >commands: > >> > > >> >$ mkdir app > >> >$ mv www/config.xml app > >> >$ mv www app > >> >$ mv merges app > >> > > >> >All docs and tests are updated as well. Any problems should be > >>reported on > >> >JIRA and assigned to me. > >> > > >> >Braden > >> > >> > >