Add a documentation page about configuration vs. content migrations [#2921971]

Problem/Motivation

Quite typical upgrade flow to Drupal 8 is as follows:

Build the configuration for a migration. (drush migrate-upgrade --configure-only)
Migrate the structure & configuration from the old site i.e. the variables, blocks, vocabularies, node types, etc.
Override and modify the migrated configuration, build the remaining parts that could not be migrated (e.g. Views)
Migrate all content i.e. nodes, taxonomy terms, blocks, etc.

We need a page in the 'Upgrade to Drupal 8' guide on this topic. We should also include references on configuration deployment from DEV to STAGING and to PROD on this page

Remaining tasks

Postponed on #2711099: Categorize migrations according to their type
Once that lands, write the page.

Comments

Comment #1

8 November 2017 at 18:38

masipila created an issue. See original summary.

Comment #2

8 November 2017 at 18:38

Version:

8.5.x-dev

» 8.6.x-dev

Drupal 8.5.0-alpha1 will be released the week of January 17, 2018, which means new developments and disruptive changes should now be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Comment #3

masipila CreditAttribution: masipila as a volunteer commented 18 February 2018 at 19:23

Status:

Postponed

» Active

#2711099: Categorize migrations according to their type has landed so this is no longer postponed.

Comment #4

masipila CreditAttribution: masipila as a volunteer commented 24 February 2018 at 12:16

Status:

Active

» Needs review

This is now documented in the handbook, see https://www.drupal.org/docs/8/upgrade/choosing-the-upgrade-approach#cont...

Next steps for peer review:

Please review the handbook page

If you have minor improvements, feel free to make the directly to the handbook page and mark this issue as fixed.
If you have more comments, drop a comment on this issue and change the status of this issue to Needs work.

Cheers,
Markus

Comment #5

quietone CreditAttribution: quietone as a volunteer commented 24 February 2018 at 12:33

Another lovely addition to the migrate documentation! The only possible change my tired brain thinks of is to somehow emphasis that
'4' should just be content. But a different color or more text on the diagram could also be distracting. The simplicity of it encourages you to read the legend plus it looks good.

I think this is RTBC, but I will wait until the morning to do that so I can re-read it with a clearer head.