Merge branch 'trizzi-master-patch-42382' into 'master'

Add example requests for publishing packages with deploy tokens

See merge request gitlab-org/gitlab!56396

doc/user/packages/generic_packages/index.md

@@ -53,7 +53,7 @@ PUT /projects/:id/packages/generic/:package_name/:package_version/:file_name?sta
 
 Provide the file context in the request body.
 
-Example request:
+Example request using a personal access token:
 
 ```shell
 curl --header "PRIVATE-TOKEN: <your_access_token>" \
@@ -69,6 +69,22 @@ Example response:
 }
 ```
 
+Example request using a deploy token:
+
+```shell
+curl --header "DEPLOY-TOKEN: <deploy_token>" \
+     --upload-file path/to/file.txt \
+     "https://gitlab.example.com/api/v4/projects/24/packages/generic/my_package/0.0.1/file.txt?status=hidden"
+```
+
+Example response:
+
+```json
+{
+  "message":"201 Created"
+}
+```
+
 ## Download package file
 
 Download a package file.

doc/user/project/deploy_tokens/index.md

@@ -130,6 +130,22 @@ To pull packages in the GitLab package registry, you must:
 1. For the [package type of your choice](../../packages/index.md), follow the
    authentication instructions for deploy tokens.
 
+Example request publishing a generic package using a deploy token:
+
+```shell
+curl --header "DEPLOY-TOKEN: <deploy_token>" \
+     --upload-file path/to/file.txt \
+     "https://gitlab.example.com/api/v4/projects/24/packages/generic/my_package/0.0.1/file.txt?status=hidden"
+```
+
+Example response:
+
+```json
+{
+  "message":"201 Created"
+}
+```
+
 ### Push or upload packages
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/213566) in GitLab 13.0.