From 16d487ee218e668fe177e021cd827f7b3a8db76b Mon Sep 17 00:00:00 2001 From: Anthony Shew Date: Wed, 8 Jan 2025 15:43:04 -0700 Subject: [PATCH 1/3] docs: Add community made Run Summaries UI. --- docs/repo-docs/crafting-your-repository/caching.mdx | 7 +++++++ docs/repo-docs/reference/run.mdx | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/docs/repo-docs/crafting-your-repository/caching.mdx b/docs/repo-docs/crafting-your-repository/caching.mdx index 4ff884a8b64f0..dc5c59a6d760d 100644 --- a/docs/repo-docs/crafting-your-repository/caching.mdx +++ b/docs/repo-docs/crafting-your-repository/caching.mdx @@ -183,6 +183,13 @@ Turborepo has a [`--summarize` flag](/repo/docs/reference/run#--summarize) that - Debugging inputs: There are many inputs to a task in Turborepo. If a task is missing cache when you expect it to hit, you can use a Run Summary to check which inputs are different that you weren't expecting. - Debugging outputs: If cache hits aren't restoring the files you're expecting, a Run Summary can help you understand what outputs are being restored from cache. + + While there is not a Turborepo-native Run Summaries UI viewer, we encourage + you to use the community-built + [https://turbo.nullvoxpopuli.com](https://turbo.nullvoxpopuli.com) if youd + like to view your Run Summaries as a web view. + + ### Turning off caching Sometimes, you may not want to write the output of tasks to the cache. This can be set permanently for a task using [`"cache": false`](/repo/docs/reference/configuration#cache) or for a whole run using [ the `--no-cache` flag](/repo/docs/reference/run#--no-cache). diff --git a/docs/repo-docs/reference/run.mdx b/docs/repo-docs/reference/run.mdx index 304643fc64a9d..3e190fc12a048 100644 --- a/docs/repo-docs/reference/run.mdx +++ b/docs/repo-docs/reference/run.mdx @@ -547,6 +547,13 @@ This flag can be helpful for debugging to determine things like: - What inputs changed between two task runs to produce a cache miss - How task timings changed over time + + While there is not a Turborepo-native Run Summaries UI viewer, we encourage + you to use the community-built + [https://turbo.nullvoxpopuli.com](https://turbo.nullvoxpopuli.com) if youd + like to view your Run Summaries as a web view. + + ### `--token` A bearer token for Remote Caching. Useful for running in non-interactive shells in combination with the `--team` flag. From 08d00644ccc86e813307539e07732acf7b569fca Mon Sep 17 00:00:00 2001 From: Anthony Shew Date: Thu, 9 Jan 2025 01:05:41 -0700 Subject: [PATCH 2/3] Update docs/repo-docs/crafting-your-repository/caching.mdx Co-authored-by: Thomas Knickman --- docs/repo-docs/crafting-your-repository/caching.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/repo-docs/crafting-your-repository/caching.mdx b/docs/repo-docs/crafting-your-repository/caching.mdx index dc5c59a6d760d..e0867a09e1aa2 100644 --- a/docs/repo-docs/crafting-your-repository/caching.mdx +++ b/docs/repo-docs/crafting-your-repository/caching.mdx @@ -186,7 +186,7 @@ Turborepo has a [`--summarize` flag](/repo/docs/reference/run#--summarize) that While there is not a Turborepo-native Run Summaries UI viewer, we encourage you to use the community-built - [https://turbo.nullvoxpopuli.com](https://turbo.nullvoxpopuli.com) if youd + [https://turbo.nullvoxpopuli.com](https://turbo.nullvoxpopuli.com) if you would like to view your Run Summaries as a web view. From 2cac831634b7ae31cba7e7bcb03058feb514f323 Mon Sep 17 00:00:00 2001 From: Anthony Shew Date: Thu, 9 Jan 2025 01:06:36 -0700 Subject: [PATCH 3/3] Update docs/repo-docs/reference/run.mdx Co-authored-by: Thomas Knickman --- docs/repo-docs/reference/run.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/repo-docs/reference/run.mdx b/docs/repo-docs/reference/run.mdx index 3e190fc12a048..bf476551b0f6e 100644 --- a/docs/repo-docs/reference/run.mdx +++ b/docs/repo-docs/reference/run.mdx @@ -550,7 +550,7 @@ This flag can be helpful for debugging to determine things like: While there is not a Turborepo-native Run Summaries UI viewer, we encourage you to use the community-built - [https://turbo.nullvoxpopuli.com](https://turbo.nullvoxpopuli.com) if youd + [https://turbo.nullvoxpopuli.com](https://turbo.nullvoxpopuli.com) if you would like to view your Run Summaries as a web view.