Merge branch '36424-add-job-token-to-nuget-doc' into 'master'

Add job tokens example to nuget docs

Closes #36424

See merge request gitlab-org/gitlab!39317

doc/user/packages/nuget_repository/index.md

@@ -236,3 +236,35 @@ Where:
 
 - `<package_id>` is the package ID.
 - `<package_version>` (Optional) is the package version.
+
+## Publishing a NuGet package with CI/CD
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/36424) in GitLab 13.3.
+
+If you’re using NuGet with GitLab CI/CD, a CI job token can be used instead of a personal access token or deploy token.
+The token inherits the permissions of the user that generates the pipeline.
+
+This example shows how to create a new package each time the `master` branch
+is updated:
+
+1. Add a `deploy` job to your `.gitlab-ci.yml` file:
+
+   ```yaml
+    image: mcr.microsoft.com/dotnet/core/sdk:3.1
+
+    stages:
+      - deploy
+
+    deploy:
+      stage: deploy
+      script:
+        - dotnet restore -p:Configuration=Release
+        - dotnet build -c Release
+        - dotnet pack -c Release
+        - dotnet nuget add source "$CI_SERVER_URL/api/v4/projects/$CI_PROJECT_ID/packages/nuget/index.json" --name gitlab --username gitlab-ci-token --password $CI_JOB_TOKEN --store-password-in-clear-text
+        - dotnet nuget push "bin/Release/*.nupkg" --source gitlab
+      only:
+        - master
+   ```
+
+1. Commit the changes and push it to your GitLab repository to trigger a new CI build.

doc/user/packages/package_registry/index.md

@@ -26,13 +26,12 @@ For information on how to create and upload a package, view the GitLab documenta
 ## Use GitLab CI/CD to build packages
 
 You can use [GitLab CI/CD](../../../ci/README.md) to build packages.
-For Maven and NPM packages, and Composer dependencies, you can
+For Maven, NuGet and NPM packages, and Composer dependencies, you can
 authenticate with GitLab by using the `CI_JOB_TOKEN`.
 
 CI/CD templates, which you can use to get started, are in [this repo](https://gitlab.com/gitlab-org/gitlab/-/tree/master/lib/gitlab/ci/templates).
 
-Learn more about [using CI/CD to build Maven packages](../maven_repository/index.md#creating-maven-packages-with-gitlab-cicd)
-and [NPM packages](../npm_registry/index.md#publishing-a-package-with-cicd).
+Learn more about [using CI/CD to build Maven packages](../maven_repository/index.md#creating-maven-packages-with-gitlab-cicd), [NPM packages](../npm_registry/index.md#publishing-a-package-with-cicd) and [NuGet Packages](../nuget_repository/index.md#publishing-a-nuget-package-with-cicd).
 
 If you use CI/CD to build a package, extended activity
 information is displayed when you view the package details: