Task/review documentation

Review and update the documentation.
Of course, only for the fields that make sense. E.g. password doesn't need any example.