Explicitly include user identifiers in related.user field descripti…

…on (elastic#1420)

* explicitly include user identifiers in description

* update artifacts

* changelog
# Conflicts:
#	experimental/generated/csv/fields.csv
#	generated/csv/fields.csv

CHANGELOG.next.md

@@ -23,6 +23,7 @@ Thanks, you're awesome :-) -->
 
 * Fix ecs GitHub repo link source branch #1393
 * Add --exclude flag to Generator to support field removal testing #1411
+* Explicitly include user identifiers in `relater.user` description. #1420
 
 #### Deprecated
 

docs/field-details.asciidoc

@@ -6638,7 +6638,7 @@ Note: this field should contain an array of values.
 [[field-related-user]]
 <<field-related-user, related.user>>
 
-| All the user names seen on your event.
+| All the user names or other user identifiers seen on the event.
 
 type: keyword
 

experimental/generated/beats/fields.ecs.yml

@@ -6111,7 +6111,7 @@
       level: extended
       type: keyword
       ignore_above: 1024
-      description: All the user names seen on your event.
+      description: All the user names or other user identifiers seen on the event.
       default_field: false
   - name: rule
     title: Rule

experimental/generated/csv/fields.csv

@@ -706,7 +706,7 @@ ECS_Version,Indexed,Field_Set,Field,Type,Level,Normalization,Example,Description
 1.11.0-dev+exp,true,related,related.hash,keyword,extended,array,,All the hashes seen on your event.
 1.11.0-dev+exp,true,related,related.hosts,keyword,extended,array,,All the host identifiers seen on your event.
 1.11.0-dev+exp,true,related,related.ip,ip,extended,array,,All of the IPs seen on your event.
-1.11.0-dev+exp,true,related,related.user,keyword,extended,array,,All the user names seen on your event.
+1.11.0-dev+exp,true,related,related.user,keyword,extended,array,,All the user names or other user identifiers seen on the event.
 1.11.0-dev+exp,true,rule,rule.author,keyword,extended,array,"[""Star-Lord""]",Rule author
 1.11.0-dev+exp,true,rule,rule.category,keyword,extended,,Attempted Information Leak,Rule category
 1.11.0-dev+exp,true,rule,rule.description,keyword,extended,,Block requests to public DNS over HTTPS / TLS protocols,Rule description

experimental/generated/ecs/ecs_flat.yml

@@ -8866,14 +8866,14 @@ related.ip:
   type: ip
 related.user:
   dashed_name: related-user
-  description: All the user names seen on your event.
+  description: All the user names or other user identifiers seen on the event.
   flat_name: related.user
   ignore_above: 1024
   level: extended
   name: user
   normalize:
   - array
-  short: All the user names seen on your event.
+  short: All the user names or other user identifiers seen on the event.
   type: keyword
 rule.author:
   dashed_name: rule-author

experimental/generated/ecs/ecs_nested.yml

@@ -10800,14 +10800,14 @@ related:
       type: ip
     related.user:
       dashed_name: related-user
-      description: All the user names seen on your event.
+      description: All the user names or other user identifiers seen on the event.
       flat_name: related.user
       ignore_above: 1024
       level: extended
       name: user
       normalize:
       - array
-      short: All the user names seen on your event.
+      short: All the user names or other user identifiers seen on the event.
       type: keyword
   group: 2
   name: related

generated/beats/fields.ecs.yml

@@ -5126,7 +5126,7 @@
       level: extended
       type: keyword
       ignore_above: 1024
-      description: All the user names seen on your event.
+      description: All the user names or other user identifiers seen on the event.
       default_field: false
   - name: rule
     title: Rule

generated/csv/fields.csv

@@ -582,7 +582,7 @@ ECS_Version,Indexed,Field_Set,Field,Type,Level,Normalization,Example,Description
 1.11.0-dev,true,related,related.hash,keyword,extended,array,,All the hashes seen on your event.
 1.11.0-dev,true,related,related.hosts,keyword,extended,array,,All the host identifiers seen on your event.
 1.11.0-dev,true,related,related.ip,ip,extended,array,,All of the IPs seen on your event.
-1.11.0-dev,true,related,related.user,keyword,extended,array,,All the user names seen on your event.
+1.11.0-dev,true,related,related.user,keyword,extended,array,,All the user names or other user identifiers seen on the event.
 1.11.0-dev,true,rule,rule.author,keyword,extended,array,"[""Star-Lord""]",Rule author
 1.11.0-dev,true,rule,rule.category,keyword,extended,,Attempted Information Leak,Rule category
 1.11.0-dev,true,rule,rule.description,keyword,extended,,Block requests to public DNS over HTTPS / TLS protocols,Rule description

generated/ecs/ecs_flat.yml

@@ -7443,14 +7443,14 @@ related.ip:
   type: ip
 related.user:
   dashed_name: related-user
-  description: All the user names seen on your event.
+  description: All the user names or other user identifiers seen on the event.
   flat_name: related.user
   ignore_above: 1024
   level: extended
   name: user
   normalize:
   - array
-  short: All the user names seen on your event.
+  short: All the user names or other user identifiers seen on the event.
   type: keyword
 rule.author:
   dashed_name: rule-author

generated/ecs/ecs_nested.yml

@@ -9013,14 +9013,14 @@ related:
       type: ip
     related.user:
       dashed_name: related-user
-      description: All the user names seen on your event.
+      description: All the user names or other user identifiers seen on the event.
       flat_name: related.user
       ignore_above: 1024
       level: extended
       name: user
       normalize:
       - array
-      short: All the user names seen on your event.
+      short: All the user names or other user identifiers seen on the event.
       type: keyword
   group: 2
   name: related

schemas/related.yml

@@ -29,7 +29,8 @@
       level: extended
       type: keyword
       description: >
-        All the user names seen on your event.
+        All the user names or other user identifiers seen on the event.
+
       normalize:
         - array