Repo sync

content/actions/concepts/workflows-and-actions/index.md

@@ -14,6 +14,7 @@ children:
   - /contexts
   - /expressions
   - /deployment-environments
+  - /workflow-artifacts
   - /dependency-caching
   - /about-monitoring-workflows
   - /notifications-for-workflow-runs

content/actions/concepts/workflows-and-actions/workflow-artifacts.md

@@ -0,0 +1,43 @@
+---
+title: Workflow artifacts
+intro: 'Learn about storing and sharing data as artifacts of {% data variables.product.prodname_actions %} workflows.'
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+type: overview
+topics:
+  - Actions
+  - Workflows
+---
+
+## About workflow artifacts
+
+An artifact is a file or collection of files produced during a workflow run. Artifacts allow you to persist data after a job has completed, and share that data with another job in the same workflow. For example, you can use artifacts to save your build and test output after a workflow run has ended.
+
+{% data variables.product.github %} provides two actions that you can use to upload and download build artifacts, {% ifversion fpt or ghec %}[upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact){% else %} `upload-artifact` and `download-artifact` on {% data variables.product.prodname_ghe_server %}{% endif %}.
+
+Common artifacts include:
+
+* Log files and core dumps
+* Test results, failures, and screenshots
+* Binary or compressed files
+* Stress test performance output and code coverage results
+
+{% data reusables.actions.comparing-artifacts-caching %}
+
+For more information on dependency caching, see [AUTOTITLE](/actions/using-workflows/caching-dependencies-to-speed-up-workflows#comparing-artifacts-and-dependency-caching).
+
+{% ifversion artifact-attestations %}
+
+## Generating artifact attestations for builds
+
+{% data reusables.actions.about-artifact-attestations %}
+
+You can access attestations after a build run, underneath the list of the artifacts the build produced.
+
+For more information, see [AUTOTITLE](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds).
+
+{% endif %}
+
+{% data reusables.actions.artifacts.artifacts-from-deleted-workflow-runs %}

content/actions/how-tos/use-cases-and-examples/index.md

@@ -10,7 +10,6 @@ redirect_from:
   - /actions/examples
   - /actions/use-cases-and-examples
 children:
-  - building-and-testing
   - publishing-packages
   - project-management
   - using-containerized-services

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-go.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-go.md

@@ -1,17 +1,17 @@
 ---
 title: Building and testing Go
-intro: You can create a continuous integration (CI) workflow to build and test your Go project.
+intro: Learn how to create a continuous integration (CI) workflow to build and test your Go project.
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
 shortTitle: Build & test Go
 redirect_from:
   - /actions/automating-builds-and-tests/building-and-testing-go
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-go
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-go
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-java-with-ant.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-java-with-ant.md

@@ -1,6 +1,6 @@
 ---
 title: Building and testing Java with Ant
-intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Ant.
+intro: Learn how to create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Ant.
 redirect_from:
   - /actions/language-and-framework-guides/building-and-testing-java-with-ant
   - /actions/guides/building-and-testing-java-with-ant
@@ -10,7 +10,6 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Java

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-java-with-gradle.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-java-with-gradle.md

@@ -1,16 +1,16 @@
 ---
 title: Building and testing Java with Gradle
-intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Gradle.
+intro: Learn how to create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Gradle.
 redirect_from:
   - /actions/language-and-framework-guides/building-and-testing-java-with-gradle
   - /actions/guides/building-and-testing-java-with-gradle
   - /actions/automating-builds-and-tests/building-and-testing-java-with-gradle
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-java-with-gradle
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-java-with-gradle
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Java

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-java-with-maven.md

@@ -1,16 +1,16 @@
 ---
 title: Building and testing Java with Maven
-intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Maven.
+intro: Learn how to create a continuous integration (CI) workflow in GitHub Actions to build and test your Java project with Maven.
 redirect_from:
   - /actions/language-and-framework-guides/building-and-testing-java-with-maven
   - /actions/guides/building-and-testing-java-with-maven
   - /actions/automating-builds-and-tests/building-and-testing-java-with-maven
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Java

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-net.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-net.md

@@ -1,10 +1,11 @@
 ---
 title: Building and testing .NET
-intro: You can create a continuous integration (CI) workflow to build and test your .NET project.
+intro: Learn how to create a continuous integration (CI) workflow to build and test your .NET project.
 redirect_from:
   - /actions/guides/building-and-testing-net
   - /actions/automating-builds-and-tests/building-and-testing-net
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-net
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-net
 versions:
   fpt: '*'
   ghes: '*'

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-nodejs.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-nodejs.md

@@ -1,17 +1,17 @@
 ---
 title: Building and testing Node.js
-intro: You can create a continuous integration (CI) workflow to build and test your Node.js project.
+intro: Learn how to create a continuous integration (CI) workflow to build and test your Node.js project.
 redirect_from:
   - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions
   - /actions/language-and-framework-guides/using-nodejs-with-github-actions
   - /actions/guides/building-and-testing-nodejs
   - /actions/automating-builds-and-tests/building-and-testing-nodejs
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-nodejs
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-nodejs
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Node

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-powershell.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-powershell.md

@@ -1,17 +1,18 @@
 ---
 title: Building and testing PowerShell
-intro: You can create a continuous integration (CI) workflow to build and test your PowerShell project.
+intro: Learn how to create a continuous integration (CI) workflow to build and test your PowerShell project.
 redirect_from:
   - /actions/guides/building-and-testing-powershell
   - /actions/automating-builds-and-tests/building-and-testing-powershell
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-powershell
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-powershell
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
 authors:
   - potatoqualitee
-type: tutorial
+
 topics:
   - CI
   - PowerShell

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-python.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-python.md

@@ -1,17 +1,17 @@
 ---
 title: Building and testing Python
-intro: You can create a continuous integration (CI) workflow to build and test your Python project.
+intro: Learn how to create a continuous integration (CI) workflow to build and test your Python project.
 redirect_from:
   - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions
   - /actions/language-and-framework-guides/using-python-with-github-actions
   - /actions/guides/building-and-testing-python
   - /actions/automating-builds-and-tests/building-and-testing-python
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-python
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-python
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Python

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-ruby.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-ruby.md

@@ -5,11 +5,11 @@ redirect_from:
   - /actions/guides/building-and-testing-ruby
   - /actions/automating-builds-and-tests/building-and-testing-ruby
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-ruby
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-ruby
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Ruby

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-rust.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-rust.md

@@ -1,16 +1,16 @@
 ---
 title: Building and testing Rust
-intro: You can create a continuous integration (CI) workflow to build and test your Rust project.
+intro: Learn how to create a continuous integration (CI) workflow to build and test your Rust project.
 versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
-type: tutorial
 topics:
   - CI
 shortTitle: Build & test Rust
 redirect_from:
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-rust
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-rust
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-swift.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-swift.md

@@ -1,15 +1,15 @@
 ---
 title: Building and testing Swift
-intro: You can create a continuous integration (CI) workflow to build and test your Swift project.
+intro: Learn how to create a continuous integration (CI) workflow to build and test your Swift project.
 redirect_from:
   - /actions/guides/building-and-testing-swift
   - /actions/automating-builds-and-tests/building-and-testing-swift
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-swift
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-swift
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Swift

content/actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-xamarin-applications.md → content/actions/how-tos/writing-workflows/building-and-testing/building-and-testing-xamarin-applications.md

@@ -1,15 +1,15 @@
 ---
 title: Building and testing Xamarin applications
-intro: You can create a continuous integration (CI) workflow in GitHub Actions to build and test your Xamarin application.
+intro: Learn how to create a continuous integration (CI) workflow in GitHub Actions to build and test your Xamarin application.
 redirect_from:
   - /actions/guides/building-and-testing-xamarin-applications
   - /actions/automating-builds-and-tests/building-and-testing-xamarin-applications
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-xamarin-applications
+  - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-xamarin-applications
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-type: tutorial
 topics:
   - CI
   - Xamarin

content/actions/how-tos/use-cases-and-examples/building-and-testing/index.md → content/actions/how-tos/writing-workflows/building-and-testing/index.md

@@ -18,6 +18,7 @@ redirect_from:
   - /actions/automating-builds-and-tests
   - /actions/examples/using-scripts-to-test-your-code-on-a-runner
   - /actions/use-cases-and-examples/building-and-testing
+  - /actions/how-tos/use-cases-and-examples/building-and-testing
 children:
   - /building-and-testing-go
   - /building-and-testing-java-with-ant

content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/index.md

@@ -21,5 +21,4 @@ children:
   - /deploying-to-a-specific-environment
   - /control-the-concurrency-of-workflows-and-jobs
   - /running-variations-of-jobs-in-a-workflow
-  - /storing-and-sharing-data-from-a-workflow
 ---

content/actions/how-tos/writing-workflows/index.md

@@ -15,5 +15,6 @@ children:
   - /choosing-when-your-workflow-runs
   - /choosing-where-your-workflow-runs
   - /choosing-what-your-workflow-does
+  - /building-and-testing
 ---
 

content/actions/index.md

@@ -16,7 +16,7 @@ featuredLinks:
   guideCards:
     - /actions/how-tos/writing-workflows/using-workflow-templates
     - /actions/how-tos/use-cases-and-examples/publishing-packages/publishing-nodejs-packages
-    - /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-powershell
+    - /actions/how-tos/writing-workflows/building-and-testing/building-and-testing-powershell
   popular:
     - /actions/reference/workflow-syntax-for-github-actions
     - /actions/how-tos/writing-workflows

content/actions/tutorials/index.md

@@ -12,10 +12,10 @@ children:
   - /creating-a-docker-container-action
   - /creating-a-javascript-action
   - /creating-a-composite-action
+  - /store-and-share-data
   - /quickstart-for-actions-runner-controller
   - /deploying-with-github-actions
   - /communicating-with-docker-service-containers
 redirect_from:
   - /actions/guides
 ---
-