That looks good Benn. The upgrading docs should look almost identical across platforms, and I think you've started it well (the big bold note about having to add the old core apis as plugins now).
A few things that I think need doing for those docs to be complete: - Plugins need READMEs. I imagine most of them will look identical other than particular ids and file references. Instructions on how to install the plugin manually, with plugman, and with cordova-cli should be provided in there. - Link to the plugins in the upgrading guides, from there users can look at the readmes to install them. - The "upgrading with cordova cli" section can then be expanded with specific commands to run to install all of the core plugins and get the same app state as in pre-3.0. Maybe add notes to encourage the user to think about which apis are really necessary for them in their app. Let me know how that sounds folks and I can add that to the windows phone upgrading guide. From there the other platforms can follow suit with the same general upgrading notes. On 7/15/13 8:15 PM, "Benn Mapes" <benn.ma...@gmail.com> wrote: >There is a document that talks about the cordova-cli : >https://github.com/apache/cordova-docs/blob/master/docs/en/edge/guide/cli/ >index.md > >But I don't see any mention of how to install the core plugins (or any >plugins...) > >For the windows phone upgrade guides I did something like this : >https://github.com/apache/cordova-docs/blob/master/docs/en/edge/guide/plat >forms/wp8/upgrading.md > >But I feel we might need a little bit more elaboration on this. > > >On Mon, Jul 15, 2013 at 6:58 PM, Shazron <shaz...@gmail.com> wrote: > >> What's the story here? I assume we all have a common one, in that we >> require the user to install cordova-cli through npm, etc and instruct >>them >> on how to add the core plugins using this tool. >> >> Have I missed a doc somewhere already written? (probably) >>