Suggestion for migration guide

I’ve been having some problems following the migration guide. I found the changes hard to understand, could they be structured differently? For example a diff. between old and new structures, such as the credentials file.

Deprecated:

access_token: "PRIVATE_TOKEN"
verify: "BOT_NAME"
webhook_url: "https:127.0.0.1:5001/webhook"

New format:

telegram:
  access_token: "PRIVATE_TOKEN"
  verify: "BOT_NAME"
  webhook_url: "https:127.0.0.1:5001/webhooks/telegram/webhook"

Or with regards to code or story data:

Deprecate domain:

actions:
#python file (.) class name 
 - actions.ActionHello

New domain:

actions:
  #custom action name
  - custom_action_hello

These were the problems I faced :wink: :grimacing: