diff --git a/documentation/index.md b/documentation/index.md index 2612d0e22b3..fe96b4909bf 100644 --- a/documentation/index.md +++ b/documentation/index.md @@ -20,7 +20,6 @@ use the Openverse API, you should instead refer to the - Storybook (UI components) -- Tailwind Config Viewer (design tokens) # Table of contents diff --git a/documentation/meta/ci_cd/actions.md b/documentation/meta/ci_cd/actions.md index a384024eb76..c5ced03f0b1 100644 --- a/documentation/meta/ci_cd/actions.md +++ b/documentation/meta/ci_cd/actions.md @@ -72,7 +72,7 @@ input, passing a space-separated list of image names. ## `build-docs` -Builds the documentation, including this Sphinx site, the frontend Storybook and -the Tailwind config viewer and stores it at `/tmp/docs`. This compiled -documentation is deployed to an appropriate location by the +Builds the documentation, including this Sphinx site and the frontend Storybook +and stores it at `/tmp/docs`. This compiled documentation is deployed to an +appropriate location by the [`emit-docs`](/meta/ci_cd/jobs/documentation.md#emit-docs) job. diff --git a/documentation/meta/ci_cd/artifacts.md b/documentation/meta/ci_cd/artifacts.md index d61a03f0641..eaa44c5ff82 100644 --- a/documentation/meta/ci_cd/artifacts.md +++ b/documentation/meta/ci_cd/artifacts.md @@ -60,10 +60,9 @@ The following artifacts are related to documentation. - `documentation` - This is the main documentation comprising of the Sphinx site, the Storybook - and the Tailwind Config Viewer. It's built by the - [`build-docs`](/meta/ci_cd/jobs/documentation.md#build-docs) job and used by - the [`emit-docs`](/meta/ci_cd/jobs/documentation.md#emit-docs) to deploy - either as the main documentation site (if the workflow is running for a new - commit pushed to `main`) or as a preview (if the workflow is running for a - PR). + This is the main documentation comprising the Sphinx site and the Storybook. + It's built by the [`build-docs`](/meta/ci_cd/jobs/documentation.md#build-docs) + job and used by the [`emit-docs`](/meta/ci_cd/jobs/documentation.md#emit-docs) + to deploy either as the main documentation site (if the workflow is running + for a new commit pushed to `main`) or as a preview (if the workflow is running + for a PR). diff --git a/documentation/meta/ci_cd/jobs/documentation.md b/documentation/meta/ci_cd/jobs/documentation.md index 11f14bb8763..a9fc00b4390 100644 --- a/documentation/meta/ci_cd/jobs/documentation.md +++ b/documentation/meta/ci_cd/jobs/documentation.md @@ -45,8 +45,7 @@ Documentation is only emitted if all the following conditions are met. - a PR and - the source is a branch of `WordPress/openverse` and not a fork - the author of the PR is not Dependabot -- either the documentation or the frontend has changed (for the Storybook and - Tailwind Config Viewer) +- either the documentation or the frontend has changed (for Storybook) - all the primary tests ([`test-cat`](/meta/ci_cd/jobs/catalog.md#test-cat), [`test-ing`](/meta/ci_cd/jobs/ingestion_server.md#test-ing), [`test-api`](/meta/ci_cd/jobs/api.md#test-api),