Add sample for updating a user and other small edits
Add sample for updating a user and other small edits

Move subscriptions section to the top. This way we can state that all
actions in Users and below require and assume user authentication to
perform shown action.

javierjulio/synapse_payments,javierjulio/synapse_payments