From f1b66f3c2c460833daefe3df2af632683ddca165 Mon Sep 17 00:00:00 2001
From: Alex Pott <alex.a.pott@googlemail.com>
Date: Thu, 3 Nov 2016 15:13:40 +0000
Subject: [PATCH] Issue #2818157 by Adita, mikeryan, heddn, alexpott: Add
 comments to remove entity ids in migration

---
 core/modules/comment/migration_templates/d6_comment.yml        | 2 ++
 core/modules/comment/migration_templates/d7_comment.yml        | 2 ++
 core/modules/file/migration_templates/d7_file.yml              | 2 ++
 core/modules/node/migration_templates/d6_node.yml              | 2 ++
 core/modules/node/migration_templates/d6_node_revision.yml     | 2 ++
 core/modules/node/migration_templates/d6_node_translation.yml  | 2 ++
 core/modules/node/migration_templates/d7_node.yml              | 2 ++
 core/modules/node/migration_templates/d7_node_revision.yml     | 2 ++
 core/modules/taxonomy/migration_templates/d6_taxonomy_term.yml | 2 ++
 core/modules/taxonomy/migration_templates/d7_taxonomy_term.yml | 2 ++
 core/modules/user/migration_templates/d6_user.yml              | 2 ++
 core/modules/user/migration_templates/d7_user.yml              | 2 ++
 12 files changed, 24 insertions(+)

diff --git a/core/modules/comment/migration_templates/d6_comment.yml b/core/modules/comment/migration_templates/d6_comment.yml
index a7ffc9dad566..f4dff98e2902 100644
--- a/core/modules/comment/migration_templates/d6_comment.yml
+++ b/core/modules/comment/migration_templates/d6_comment.yml
@@ -7,6 +7,8 @@ source:
   constants:
     entity_type: node
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the cid field to allow incremental migrations.
   cid: cid
   pid:
     plugin: migration
diff --git a/core/modules/comment/migration_templates/d7_comment.yml b/core/modules/comment/migration_templates/d7_comment.yml
index 5845999dae1c..d4e3c57cb1b8 100644
--- a/core/modules/comment/migration_templates/d7_comment.yml
+++ b/core/modules/comment/migration_templates/d7_comment.yml
@@ -7,6 +7,8 @@ source:
   constants:
     entity_type: node
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the cid field to allow incremental migrations.
   cid: cid
   pid:
     plugin: migration
diff --git a/core/modules/file/migration_templates/d7_file.yml b/core/modules/file/migration_templates/d7_file.yml
index ffd85ab55ba5..7ebf83bf32d9 100644
--- a/core/modules/file/migration_templates/d7_file.yml
+++ b/core/modules/file/migration_templates/d7_file.yml
@@ -13,6 +13,8 @@ source:
     # configuration in this migration's process pipeline as an example.
     source_base_path: ''
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the fid field to allow incremental migrations.
   fid: fid
   filename: filename
   source_full_path:
diff --git a/core/modules/node/migration_templates/d6_node.yml b/core/modules/node/migration_templates/d6_node.yml
index 58aea356d682..4e19bb407f7d 100644
--- a/core/modules/node/migration_templates/d6_node.yml
+++ b/core/modules/node/migration_templates/d6_node.yml
@@ -9,6 +9,8 @@ process:
   # In D6, nodes always have a tnid, but it's zero for untranslated nodes.
   # We normalize it to equal the nid in that case.
   # @see \Drupal\node\Plugin\migrate\source\d6\Node::prepareRow().
+  # If you are using this file to build a custom migration consider removing
+  # the nid and vid fields to allow incremental migrations.
   nid: tnid
   vid: vid
   langcode:
diff --git a/core/modules/node/migration_templates/d6_node_revision.yml b/core/modules/node/migration_templates/d6_node_revision.yml
index b7826a18b3d6..046e9bbe4c56 100644
--- a/core/modules/node/migration_templates/d6_node_revision.yml
+++ b/core/modules/node/migration_templates/d6_node_revision.yml
@@ -6,6 +6,8 @@ deriver: Drupal\node\Plugin\migrate\D6NodeDeriver
 source:
   plugin: d6_node_revision
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the nid and vid fields to allow incremental migrations.
   nid: nid
   vid: vid
   langcode:
diff --git a/core/modules/node/migration_templates/d6_node_translation.yml b/core/modules/node/migration_templates/d6_node_translation.yml
index b4a240217137..07440ab5b50a 100644
--- a/core/modules/node/migration_templates/d6_node_translation.yml
+++ b/core/modules/node/migration_templates/d6_node_translation.yml
@@ -7,6 +7,8 @@ source:
   plugin: d6_node
   translations: true
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the nid field to allow incremental migrations.
   nid: tnid
   type: type
   langcode:
diff --git a/core/modules/node/migration_templates/d7_node.yml b/core/modules/node/migration_templates/d7_node.yml
index b763534dd19f..381f7ce70c97 100644
--- a/core/modules/node/migration_templates/d7_node.yml
+++ b/core/modules/node/migration_templates/d7_node.yml
@@ -6,6 +6,8 @@ deriver: Drupal\node\Plugin\migrate\D7NodeDeriver
 source:
   plugin: d7_node
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the nid and vid fields to allow incremental migrations.
   nid: nid
   vid: vid
   langcode:
diff --git a/core/modules/node/migration_templates/d7_node_revision.yml b/core/modules/node/migration_templates/d7_node_revision.yml
index 0ee8bca6e52d..c6081ef11044 100644
--- a/core/modules/node/migration_templates/d7_node_revision.yml
+++ b/core/modules/node/migration_templates/d7_node_revision.yml
@@ -6,6 +6,8 @@ deriver: Drupal\node\Plugin\migrate\D7NodeDeriver
 source:
   plugin: d7_node_revision
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the nid and vid fields to allow incremental migrations.
   nid: nid
   vid: vid
   langcode:
diff --git a/core/modules/taxonomy/migration_templates/d6_taxonomy_term.yml b/core/modules/taxonomy/migration_templates/d6_taxonomy_term.yml
index 44f9f7fb6f9d..909fb4c11631 100644
--- a/core/modules/taxonomy/migration_templates/d6_taxonomy_term.yml
+++ b/core/modules/taxonomy/migration_templates/d6_taxonomy_term.yml
@@ -5,6 +5,8 @@ migration_tags:
 source:
   plugin: taxonomy_term
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the tid field to allow incremental migrations.
   tid: tid
   vid:
     plugin: migration
diff --git a/core/modules/taxonomy/migration_templates/d7_taxonomy_term.yml b/core/modules/taxonomy/migration_templates/d7_taxonomy_term.yml
index 8d4adbbed668..a47ab46b989f 100644
--- a/core/modules/taxonomy/migration_templates/d7_taxonomy_term.yml
+++ b/core/modules/taxonomy/migration_templates/d7_taxonomy_term.yml
@@ -5,6 +5,8 @@ migration_tags:
 source:
   plugin: taxonomy_term
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the tid field to allow incremental migrations.
   tid: tid
   vid:
     plugin: migration
diff --git a/core/modules/user/migration_templates/d6_user.yml b/core/modules/user/migration_templates/d6_user.yml
index fa6326e930b2..c82c65750981 100644
--- a/core/modules/user/migration_templates/d6_user.yml
+++ b/core/modules/user/migration_templates/d6_user.yml
@@ -5,6 +5,8 @@ migration_tags:
 source:
   plugin: d6_user
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the uid field to allow incremental migrations.
   uid: uid
   name: name
   pass: pass
diff --git a/core/modules/user/migration_templates/d7_user.yml b/core/modules/user/migration_templates/d7_user.yml
index b72e8c72892b..3910659fa391 100644
--- a/core/modules/user/migration_templates/d7_user.yml
+++ b/core/modules/user/migration_templates/d7_user.yml
@@ -6,6 +6,8 @@ class: Drupal\user\Plugin\migrate\User
 source:
   plugin: d7_user
 process:
+  # If you are using this file to build a custom migration consider removing
+  # the uid field to allow incremental migrations.
   uid: uid
   name: name
   pass: pass
-- 
GitLab