More examples and better documentation

Author: willianpaixao

docs/data-sources/user.md

@@ -11,6 +11,7 @@ data "gitlab_user" "example" {
 ```
 
 ### Example using `for_each`
+
 ```hcl
 data "gitlab_user" "example-two" {
   for_each = toset(["user1", "user2", "user3"])
@@ -29,7 +30,7 @@ The following arguments are supported:
 
 * `user_id` - (Optional) The ID of the user.
 
--> **Note** Only one of email, user_id, or username must be provided.
+-> Only one of email, user_id, or username must be provided.
 
 ## Attributes Reference
 
@@ -85,4 +86,4 @@ The following arguments are supported:
 
 * `current_sign_in_at` - Current user's sign-in date.
 
--> **Note** Some attributes might not be returned depending on if you're an admin or not. Please refer to [Gitlab documentation](https://docs.gitlab.com/ce/api/users.html#single-user) for more details.
+-> Some attributes might not be returned depending on if you're an admin or not. Please refer to [Gitlab documentation](https://docs.gitlab.com/ce/api/users.html#single-user) for more details.

docs/resources/branch_protection.md

@@ -2,7 +2,7 @@
 
 This resource allows you to protect a specific branch by an access level so that the user with less access level cannot Merge/Push to the branch.
 
--> **NOTE**: The `allowed_to_push`, `allowed_to_merge` and `code_owner_approval_required` arguments require a GitLab Premium account or above.  Please refer to [Gitlab API documentation](https://docs.gitlab.com/ee/api/protected_branches.html) for further information.
+-> The `allowed_to_push`, `allowed_to_merge` and `code_owner_approval_required` arguments require a GitLab Premium account or above.  Please refer to [Gitlab API documentation](https://docs.gitlab.com/ee/api/protected_branches.html) for further information.
 
 ## Example Usage
 

docs/resources/project_approval_rule.md

@@ -37,6 +37,7 @@ resource "gitlab_project_approval_rule" "example-two" {
 ```
 
 ### Example using `data.gitlab_user` and `for` loop
+
 ```hcl
 data "gitlab_user" "users" {
   for_each = toset(["user1", "user2", "user3"])

docs/resources/user.md

@@ -3,7 +3,7 @@
 This resource allows you to create and manage GitLab users.
 Note your provider will need to be configured with admin-level access for this resource to work.
 
--> **Note:** You must specify either `password` or `reset_password`.
+-> You must specify either `password` or `reset_password`.
 
 ## Example Usage
 
@@ -33,7 +33,7 @@ The following arguments are supported:
 
 * `password` - (Optional) The password of the user.
 
-* `is_admin` - (Optional) Boolean, defaults to false.  Whether to enable administrative priviledges
+* `is_admin` - (Optional) Boolean, defaults to false.  Whether to enable administrative privileges
 for the user.
 
 * `projects_limit` - (Optional) Integer, defaults to 0.  Number of projects user can create.