diff --git a/README.md b/README.md index 7f977d4..609731f 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Arm Docs GitHub Action -This repository contains GitHub Actions for validating and publishing Arm documentation sites with `docs-action`. +This repository contains internal GitHub Actions used by Arm product teams to validate and publish documentation sites to [developer.arm.com](https://developer.arm.com/). Application developers need clear, high quality documentation that helps them succeed on Arm hardware and with Arm tools more quickly. Product documentation should help users complete the task in front of them, without distracting them with unnecessary surrounding context. @@ -8,7 +8,7 @@ This documentation system exists to give product teams a common way to publish d Each product team maintains its own documentation in its own repository and publishes its own independent documentation site. The shared part of the system is not a single combined site, but a common documentation generator and publishing model used across products. -This GitHub action is the entry point for teams to publish their docs to a shared documentation portal under developer.arm.com in a way that is decentralised and easy to use. +This GitHub action is the entry point for teams to publish their docs to a shared documentation portal under [developer.arm.com](https://developer.arm.com/) in a way that is decentralised and easy to use. The actions, workflows, and publishing model in this repository are designed for Arm-owned documentation repositories and Arm's internal publishing process. ## Usage diff --git a/changes/20260612111348.misc b/changes/20260612111348.misc new file mode 100644 index 0000000..fecb9ba --- /dev/null +++ b/changes/20260612111348.misc @@ -0,0 +1 @@ +:gear: Update documentation to clarify usage of the GitHub action