updated changelogs and upgrade guide

packages/terra-avatar/CHANGELOG.md

@@ -4,8 +4,10 @@ ChangeLog
 Unreleased
 ----------
 ### Breaking Changes
-* `generic` subcomponent replaces the `sharedUser` subcomponent
-* `generic` subcomponent contains a `variant` prop that toggles between `single-user`, `shared-user`, and `provider`.
+* To Make all User avatars available in same variant `generic` subcomponent has been added.
+* `generic` subcomponent replaces the `sharedUser` subcomponent.
+* `generic` subcomponent contains a `variant` prop that toggles between `single-user`, `shared-user`, and `provider` user avatar.
+* User icon has been moved from default varaint to `single-user` variant.
 
 2.29.0 - (October 3, 2019)
 ------------------

packages/terra-avatar/docs/upgrade-guide.md

@@ -1,12 +1,16 @@
 # terra-avatar Upgrade Guide
 ## Changes from version 2 to version 3
 
+### Reason for Upgrade
+* To group all user avatars in single variant `shared-user` has been replaced with `generic` sub-component
+* To keep adding new user avatars like `provider` easier new `generic` sub-component has been added with all user avatars as variants. 
+
 ### Removed
 * `Shared User` subcomponent From Avatar
 
 ### Added
-* the `generic` subcomponent that replaces the `sharedUser` subcomponent with a new `variant` prop that can be `single-user`, `shared-user`, or `provider`.
-* `variant` prop this will take values for sub-variants `single-user`, `shared-user` and `provider`.
+* The `generic` subcomponent that replaces the `sharedUser` subcomponent with a new `variant` prop that can be `single-user`, `shared-user`, or `provider`.
+* `variant` prop will take values for sub-variants `single-user`, `shared-user` and `provider`..
 
 ### Steps to uplift to V3
 1. Use a named export for Generic variant.