Add latest changes from gitlab-org/gitlab@master

2 files changed, 17 insertions, 2 deletions

diff --git a/doc/ci/docker/using_docker_images.md b/doc/ci/docker/using_docker_images.md
index 489791141ed..e58fe5e4604 100644
--- a/doc/ci/docker/using_docker_images.md
+++ b/doc/ci/docker/using_docker_images.md
@@ -576,8 +576,8 @@ There are two ways to determine the value of `DOCKER_AUTH_CONFIG`:
   will use the available system keystore to store the result of `docker
   login`. In that case, it's impossible to read `~/.docker/config.json`,
   so you will need to prepare the required base64-encoded version of
-  `${username}:${password}` manually. Open a terminal and execute the
-  following command:
+  `${username}:${password}` and create the Docker configuration JSON manually.
+  Open a terminal and execute the following command:
 
   ```bash
   echo -n "my_username:my_password" | base64
@@ -585,6 +585,18 @@ There are two ways to determine the value of `DOCKER_AUTH_CONFIG`:
   # Example output to copy
   bXlfdXNlcm5hbWU6bXlfcGFzc3dvcmQ=
   ```
+  
+  Create the Docker JSON configuration content as follows:
+
+  ```json
+  {
+      "auths": {
+          "registry.example.com:5000": {
+              "auth": "(Base64 content from above)"
+          }
+      }
+  }
+  ```
 
 #### Configuring a job
 
diff --git a/doc/development/testing_guide/end_to_end/resources.md b/doc/development/testing_guide/end_to_end/resources.md
index 1e32db4f633..b8a093c54c6 100644
--- a/doc/development/testing_guide/end_to_end/resources.md
+++ b/doc/development/testing_guide/end_to_end/resources.md
@@ -44,6 +44,9 @@ create the resource via the public GitLab API:
 - `#api_post_path`: The `POST` path to create a new resource.
 - `#api_post_body`: The `POST` body (as a Ruby hash) to create a new resource.
 
+> Be aware that many API resources are [paginated](../../../api/README.md#pagination).
+> If you don't find the results you expect, check if there is more that one page of results.
+
 Let's take the `Shirt` resource class, and add these three API methods:
 
 ```ruby