anchor.diff:  <titleabbrev>Create or update users</titleabbrev>
   ++++
   
  -Adds and updates users in the native realm. These users are commonly referred 
  +Adds and updates users in the native realm. These users are commonly referred
   to as _native users_.
   
   
  
positive.code: 
  `POST /_security/user/<username>` +
  
  `PUT /_security/user/<username>` 
  
  
  [[security-api-put-user-prereqs]]
  
negative.code: (object) Arbitrary metadata that you want to associate with the user.
  
  `password`::
  (Required<<not-always-required,*>>, string) The user's password. Passwords must be at least 6 characters long.
  +
  When adding a user, one of `password` or `password_hash` is required.
  When updating an existing user, the password is optional, so that other
  