docs: add module.id removal to moving doc

[filipesilva]

CLI projects don't need it, and soon Quickstart projects won't need it either so we might as well remove it.

[filipesilva]

@Brocco @johnpapa @wardbell do you think having the typings.d.ts file (#5193) is still necessary if we add module.id removal to the moving in docs?

The CLI doesn't need it and soon neither will the Quickstart. If we remove that file then 1.0 wouldn't need to have it.

[johnpapa]

Why won't the quickstart need it? The intention , I had thought, was to have 2 quickstarts:

1. CLI
2. w/o CLI using SystemJS

The latter will need the module.id AFAIK.

My concern is that there is a lot of code out there that has module.id now, due to SystemJS. I think it's best if we continue to show both techniques, even though we clearly have chosen WebPack as the answer.

Thoughts?

[filipesilva]

@johnpapa: @Foxandxss is working on a SystemJS plugin that does away with the need for module.id in the quickstart and all docs examples. So on the docs side, soon there will be no module.id.

It is true that there is a lot of code out there that uses it, but the changes in this PR (to the moving in guide) would help in that, and thus we would be phasing out module.id in general.

[Foxandxss]

Perhaps and I say perhaps I would change the wording for something like "you may have", because we expect no one to have moduleId soon.

[johnpapa]

It would be nice to have a way for folks to add that plugin, even if they didnt use the CLI.

Since we have promoted this module.id technique for well over a year (for those not in the CLI), I can see value in having a short instruction on how to add this new plugin for SystemJS that would eliminate the need for it.

[Foxandxss]

Well, the plugin is specifically for those not using the CLI but only raw system.js.

Perhaps we could release it out on npm so we can tell people to npm install it and how to add it to the systemjs.config.js.

[johnpapa]

I think it would be helpful to many. There is a lot, and I mean a lot, of code with module.id today. I think writing this up no how to remove it and add this plugin (easy for them( OR go to the CLI (better for us, but may feel like more work) is good. This gives folks 2 valid options.

Just to shed some light on why I feel so strongly that we need to help folks ... I have bene asked about module.id and why it broke over 50 times already in comments, email, tweets, and in person. And for every person who asks , I bet there are dozens who don't ask. So I just want to help them.

[filipesilva]

I agree then. Let's keep it in the moving in steps but not remove the typings file. Maybe we'll remove it later, or for 2.0, but we leave it in for now to easy in folks.

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}