Clarifying some confusing points on migration doc

[alexdmiller]

Some parts of the migration doc were confusing or not totally accurate, based on my experience migrating an AngularJS project from 1.0 to 1.2.7. I've tried to update the doc to clarify some confusing points.

I am completely new to AngularJS. Some of these documentation changes themselves might be inaccurate. Please look over carefully!

[mary-poppins]

Thanks for the PR! Please check the items below to help us merge this faster. See the contributing docs for more information.

• Uses the issue template (#6756)

If you need to make changes to your pull request, you can update the commit with git commit --amend.
Then, update the pull request with git push -f.

Thanks again for your help!

[mary-poppins]

I'm sorry, but I wasn't able to verify your Contributor License Agreement (CLA) signature. CLA signature is required for any code contributions to AngularJS.

Please sign our CLA and ensure that the CLA signature email address and the email address in this PR's commits match.

If you signed the CLA as a corporation, please let us know the company's name.

Thanks a bunch!

PS: If you signed the CLA in the past then most likely the email addresses don't match. Please sign the CLA again or update the email address in the commit of this PR.
PS2: If you are a Googler, please sign the CLA as well to simplify the CLA verification process.

[IgorMinar]

I'm pretty sure that we don't throw an error with this message. Isn't it something specific to your app?

[alexdmiller]

This error message is not thrown by Angular, but I think it is caused by DOM manipulations performed by Angular. This is the specific change that caused the error in our app:

c47abd0#diff-c63111838cf41936324951b4dfa9fd60

[IgorMinar]

all but the last hunk in the diff look good to me. can you provide more information about the last error?

[Narretz]

I think the version numbers should be less specific. The migration guide is for updating from 1.0.x to 1.2.x, so this should be reflected in the text.

[Foxandxss]

I like the idea to expand that last hunk. But I would reword it a little bit to match the doc style.

[alexdmiller]

Foxandxss, I decided to remove the last hunk because I think it might be a very specific part of how my app behaves... unless this is a common known issue?

[mary-poppins]

CLA signature verified! Thank you!

Someone from the team will now triage your PR and it will be processed based on the determined priority (doc updates and fixes with tests are prioritized over other changes).

[btford]

I think we should merge this now that the questionable part was amended. Ping @IgorMinar.

Thanks, @alexdmiller!

[IgorMinar]

done. thanks!