Details

    • Type: Improvement Improvement
    • Status: Resolved
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 1.0.0, 1.1.0, 1.2.0, 1.3.0, 1.4.0, 1.5.0, 1.6.0, 1.6.1, 1.7.0, 1.8.0
    • Fix Version/s: 2.0.0
    • Component/s: Docs
    • Labels:
      None

      Description

      Guidance of migrating an old PhoneGap project to a new version is not easy to find. It would be nice to have resources identifying how to upgrade a project that are easily accessible on the web (docs or phonegap download page) - this could be simple instructions which libraries to swap out, and what JS files have changed. Since there isn't much content out and easy to find now, this probably would go a long way to help PhoneGap users who want to upgrade to a newer SDK.
      (Feedback based on communication with Adobe customers)

      1.
      Document iOS Project Migration for 1.0.0 (from 0.9.6) Sub-task Resolved Steve Gill
       
      2.
      Document iOS Project Migration for 1.1.0 (from 1.0.0) Sub-task Resolved Steve Gill
       
      3.
      Document iOS Project Migration for 1.2.0 (from 1.1.0) Sub-task Resolved Steve Gill
       
      4.
      Document iOS Project Migration for 1.3.0 (from 1.2.0) Sub-task Resolved Steve Gill
       
      5.
      Document iOS Project Migration for 1.4.0 Sub-task Resolved Shazron Abdullah
       
      6.
      Document iOS Project Migration for 1.5.0 Sub-task Resolved Shazron Abdullah
       
      7.
      Document iOS Project Migration for 1.6.0 Sub-task Resolved Shazron Abdullah
       
      8.
      Document iOS Project Migration for 1.6.1 Sub-task Resolved Shazron Abdullah
       
      9.
      Document iOS Project Migration for 1.7.0 Sub-task Resolved Shazron Abdullah
       
      10.
      Document iOS Project Migration for 1.8.0 Sub-task Closed Shazron Abdullah
       
      11.
      Document Android Project Migration for 1.0.0 Sub-task Resolved Joe Bowser
       
      12.
      Document Android Project Migration for 1.1.0 Sub-task Resolved Joe Bowser
       
      13.
      Document Android Project Migration for 1.2.0 Sub-task Resolved Joe Bowser
       
      14.
      Document Android Project Migration for 1.3.0 Sub-task Resolved Joe Bowser
       
      15.
      Document Android Project Migration for 1.4.0 Sub-task Resolved Joe Bowser
       
      16.
      Document Android Project Migration for 1.5.0 Sub-task Resolved Joe Bowser
       
      17.
      Document Android Project Migration for 1.6.0 Sub-task Resolved Joe Bowser
       
      18.
      Document Android Project Migration for 1.6.1 Sub-task Resolved Joe Bowser
       
      19.
      Document Android Project Migration for 1.7.0 Sub-task Resolved Joe Bowser
       
      20.
      Document Android Project Migration for 1.8.0 Sub-task Resolved Joe Bowser
       
      21.
      Document BlackBerry Project Migration for 1.0.0 Sub-task Resolved Tim Kim
       
      22.
      Document BlackBerry Project Migration for 1.1.0 Sub-task Resolved Tim Kim
       
      23.
      Document BlackBerry Project Migration for 1.2.0 Sub-task Resolved Tim Kim
       
      24.
      Document BlackBerry Project Migration for 1.3.0 Sub-task Resolved Tim Kim
       
      25.
      Document BlackBerry Project Migration for 1.4.0 Sub-task Resolved Tim Kim
       
      26.
      Document BlackBerry Project Migration for 1.5.0 Sub-task Resolved Tim Kim
       
      27.
      Document BlackBerry Project Migration for 1.6.0 Sub-task Closed Tim Kim
       
      28.
      Document BlackBerry Project Migration for 1.6.1 Sub-task Resolved Tim Kim
       
      29.
      Document BlackBerry Project Migration for 1.7.0 Sub-task Resolved Tim Kim
       
      30.
      Document BlackBerry Project Migration for 1.8.0 Sub-task Resolved Filip Maj
       
      31.
      Document Bada Project Migration for 1.0.0 Sub-task Resolved Anis Kadri
       
      32.
      Document Bada Project Migration for 1.1.0 Sub-task Resolved Anis Kadri
       
      33.
      Document Bada Project Migration for 1.2.0 Sub-task Resolved Anis Kadri
       
      34.
      Document Bada Project Migration for 1.3.0 Sub-task Resolved Anis Kadri
       
      35.
      Document Bada Project Migration for 1.4.0 Sub-task Resolved Anis Kadri
       
      36.
      Document Bada Project Migration for 1.5.0 Sub-task Resolved Anis Kadri
       
      37.
      Document Bada Project Migration for 1.6.0 Sub-task Resolved Anis Kadri
       
      38.
      Document Bada Project Migration for 1.6.1 Sub-task Resolved Anis Kadri
       
      39.
      Document Bada Project Migration for 1.7.0 Sub-task Resolved Anis Kadri
       
      40.
      Document Bada Project Migration for 1.8.0 Sub-task Resolved Anis Kadri
       
      41.
      Document webOS Project Migration for 1.0.0 Sub-task Resolved Herm Wong
       
      42.
      Document webOS Project Migration for 1.1.0 Sub-task Resolved Herm Wong
       
      43.
      Document webOS Project Migration for 1.2.0 Sub-task Resolved Herm Wong
       
      44.
      Document webOS Project Migration for 1.3.0 Sub-task Resolved Herm Wong
       
      45.
      Document webOS Project Migration for 1.4.0 Sub-task Resolved Herm Wong
       
      46.
      Document webOS Project Migration for 1.5.0 Sub-task Resolved Herm Wong
       
      47.
      Document webOS Project Migration for 1.6.0 Sub-task Resolved Herm Wong
       
      48.
      Document webOS Project Migration for 1.6.1 Sub-task Resolved Herm Wong
       
      49.
      Document webOS Project Migration for 1.7.0 Sub-task Resolved Herm Wong
       
      50.
      Document webOS Project Migration for 1.8.0 Sub-task Resolved Herm Wong
       
      51.
      Document WP7 Project Migration for 1.0.0 Sub-task Resolved Jesse MacFadyen
       
      52.
      Document WP7 Project Migration for 1.1.0 Sub-task Resolved Jesse MacFadyen
       
      53.
      Document WP7 Project Migration for 1.2.0 Sub-task Resolved Jesse MacFadyen
       
      54.
      Document WP7 Project Migration for 1.3.0 Sub-task Resolved Jesse MacFadyen
       
      55.
      Document WP7 Project Migration for 1.4.0 Sub-task Resolved Jesse MacFadyen
       
      56.
      Document WP7 Project Migration for 1.5.0 Sub-task Resolved Jesse MacFadyen
       
      57.
      Document WP7 Project Migration for 1.6.0 Sub-task Resolved Jesse MacFadyen
       
      58.
      Document WP7 Project Migration for 1.6.1 Sub-task Resolved Jesse MacFadyen
       
      59.
      Document WP7 Project Migration for 1.7.0 Sub-task Resolved Jesse MacFadyen
       
      60.
      Document WP7 Project Migration for 1.8.0 Sub-task Closed Jesse MacFadyen
       
      61.
      Setup Migration Guide Template Sub-task Closed Michael Brooks
       
      62.
      Document webOS migration for 1.4.1 Sub-task Resolved Herm Wong
       
      63.
      Document Blackberry Project Migration for 1.9.0 Sub-task Closed Tim Kim
       

        Activity

        Transition Time In Source Status Execution Times Last Executer Last Execution Date
        Open Open In Progress In Progress
        22h 36m 1 Michael Brooks 10/May/12 18:54
        In Progress In Progress Resolved Resolved
        62d 23h 11m 1 Michael Brooks 12/Jul/12 18:05
        Hide
        Filip Maj added a comment -

        Holy shit... 63 subtasks/guides. Awesome work everyone.

        Show
        Filip Maj added a comment - Holy shit... 63 subtasks/guides. Awesome work everyone.
        Michael Brooks made changes -
        Status In Progress [ 3 ] Resolved [ 5 ]
        Resolution Fixed [ 1 ]
        Hide
        Michael Brooks added a comment -

        All platforms have implemented migration guides from 1.0.0-1.8.0

        Show
        Michael Brooks added a comment - All platforms have implemented migration guides from 1.0.0-1.8.0
        Hide
        Michael Brooks added a comment -

        I've added a placeholder to the edge documentation for upgrading each platform. I've also updated the 1.8.0 tickets for each platform with a link to the index.md file that must be completed.

        Show
        Michael Brooks added a comment - I've added a placeholder to the edge documentation for upgrading each platform. I've also updated the 1.8.0 tickets for each platform with a link to the index.md file that must be completed.
        Michael Brooks made changes -
        Fix Version/s 2.0.0 [ 12318875 ]
        Priority Major [ 3 ] Minor [ 4 ]
        Michael Brooks made changes -
        Status Open [ 1 ] In Progress [ 3 ]
        Michael Brooks made changes -
        Assignee Michael Brooks [ mwbrooks ]
        Hide
        Michael Brooks added a comment -

        Awesome suggestion Andrew and I agree, Apache Cordova needs to document this better.

        I'll start by creating sub-tasks for each platform and each release version. I think it's best to start small - as you mentioned - by documenting how to swap the binary libraries and JavaScript files. Afterwards, we can get into the gritty details of each platform (e.g. introduction of plugins.xml).

        Fil and I have decided to add the basic migration guides to the 1.8 milestone.

        Show
        Michael Brooks added a comment - Awesome suggestion Andrew and I agree, Apache Cordova needs to document this better. I'll start by creating sub-tasks for each platform and each release version. I think it's best to start small - as you mentioned - by documenting how to swap the binary libraries and JavaScript files. Afterwards, we can get into the gritty details of each platform (e.g. introduction of plugins.xml ). Fil and I have decided to add the basic migration guides to the 1.8 milestone.
        Hide
        Filip Maj added a comment -

        Yep, totally. We are on the same page here Andrew.

        Keep tabs on this issue to track progress with the guides. We will be adding guides to the docs repo, which in turn will be deployed to http://docs.phonegap.com.

        Show
        Filip Maj added a comment - Yep, totally. We are on the same page here Andrew. Keep tabs on this issue to track progress with the guides. We will be adding guides to the docs repo , which in turn will be deployed to http://docs.phonegap.com .
        Hide
        Andrew Trice added a comment -

        I agree, what is there is great, and extremely helpful. I wasn't critiquing the work that has been done. What I am suggesting is that it be more easily found online. I am aware that the content is in the dmg, but not everyone looks there, they look online/to Google first. I am suggesting that we make it easier to find this same information online.

        Currently, the workflow to find this is to download the zip file, go to lib/ios/, open the DMG, then go to "guides". This isn't intuitive or easy to find - (not a criticism of any work that has been done to date). Typically users open the DMG, run the installer, close the DMG, then never open it again.

        What I am hearing from people who are currently using PhoneGap is that they didn't even know this content existed, so we should make it easier for them to find.

        Show
        Andrew Trice added a comment - I agree, what is there is great, and extremely helpful. I wasn't critiquing the work that has been done. What I am suggesting is that it be more easily found online. I am aware that the content is in the dmg, but not everyone looks there, they look online/to Google first. I am suggesting that we make it easier to find this same information online. Currently, the workflow to find this is to download the zip file, go to lib/ios/, open the DMG, then go to "guides". This isn't intuitive or easy to find - (not a criticism of any work that has been done to date). Typically users open the DMG, run the installer, close the DMG, then never open it again. What I am hearing from people who are currently using PhoneGap is that they didn't even know this content existed, so we should make it easier for them to find.
        Filip Maj made changes -
        Affects Version/s 1.7.0 [ 12319549 ]
        Affects Version/s 1.6.1 [ 12320757 ]
        Affects Version/s 1.6.0 [ 12319548 ]
        Affects Version/s 1.5.0 [ 12319547 ]
        Affects Version/s 1.4.0 [ 12319449 ]
        Affects Version/s 1.3.0 [ 12319167 ]
        Affects Version/s 1.2.0 [ 12319166 ]
        Affects Version/s 1.1.0 [ 12318641 ]
        Affects Version/s 1.0.0 [ 12318640 ]
        Component/s iOS [ 12316400 ]
        Hide
        Filip Maj added a comment -

        Shaz has already been doing a great job writing migration guides for each version for iOS.

        Let's keep this issue as the top-level issue for migration guides as a whole in cordova. The docs should house guides for upgrading projects between specific versions.

        We should create sub-tasks in this issue for each platform, for each missing version of the guide (ideally we will write guides for previous versions as well). We still have tons of users on 1.2, 1.3, 1.4.1, etc., and they are not upgrading due to, among other things, lack of guidance in this area.

        Need to stub out markdown files in the docs for these upgrade guides.

        Show
        Filip Maj added a comment - Shaz has already been doing a great job writing migration guides for each version for iOS. Let's keep this issue as the top-level issue for migration guides as a whole in cordova. The docs should house guides for upgrading projects between specific versions. We should create sub-tasks in this issue for each platform, for each missing version of the guide (ideally we will write guides for previous versions as well). We still have tons of users on 1.2, 1.3, 1.4.1, etc., and they are not upgrading due to, among other things, lack of guidance in this area. Need to stub out markdown files in the docs for these upgrade guides.
        Brian LeRoux made changes -
        Field Original Value New Value
        Affects Version/s 1.8.0 [ 12319550 ]
        Component/s Docs [ 12316407 ]
        Component/s iOS [ 12316400 ]
        Hide
        Brian LeRoux added a comment -

        yes, shaz can you work w/ micheal to get this into the guides section of the docs?

        Show
        Brian LeRoux added a comment - yes, shaz can you work w/ micheal to get this into the guides section of the docs?
        Hide
        Andrew Trice added a comment -

        Again, Brian asked me to enter this as a bug... The content is not easily found when searching for it. This feedback is coming from Adobe customers already invested in PhoneGap/Cordova.

        Show
        Andrew Trice added a comment - Again, Brian asked me to enter this as a bug... The content is not easily found when searching for it. This feedback is coming from Adobe customers already invested in PhoneGap/Cordova.
        Hide
        Shazron Abdullah added a comment -

        There is a Guides folder in the .dmg distribution with various guides - also viewable in GitHub. Currently this is written by a dev (me). If a technical writer wants to take this on, that will be great - it's open sourced as Markdown files.

        Show
        Shazron Abdullah added a comment - There is a Guides folder in the .dmg distribution with various guides - also viewable in GitHub. Currently this is written by a dev (me). If a technical writer wants to take this on, that will be great - it's open sourced as Markdown files.
        Andrew Trice created issue -

          People

          • Assignee:
            Michael Brooks
            Reporter:
            Andrew Trice
          • Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development