Update quick-start guide with dependency error details

[therealgglggl]

Actual error output from dependency example is totally different that shown in current example

Description

Fixes #000.

TODOs

Read the Gruntwork contribution guidelines.

• I authored this code entirely myself
• I am submitting code based on open source software (e.g. MIT, MPL-2.0, Apache)]
• I am adding or upgrading a dependency or adapted code and confirm it has a compatible open source license
• Update the docs.
• Run the relevant tests successfully, including pre-commit checks.
• Include release notes. If this PR is backward incompatible, include a migration guide.

Release Notes (draft)

Added / Removed / Updated [X].

Migration Guide

Summary by CodeRabbit

• Documentation
  • Enhanced Quick Start guide with improved explanations of build order logic and dependency handling, featuring clearer run summaries and streamlined examples for better clarity.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

@therealgglggl is attempting to deploy a commit to the Gruntwork Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

📝 Walkthrough

Walkthrough

The Quick Start guide documentation is updated to replace a detailed Terragrunt error output and mock_outputs instructions with a concise Run Summary and higher-level explanation of DAG-based run order and dependency handling behavior.

Changes

Cohort / File(s)	Summary
Documentation Updates docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx	Replaces explicit error output and dependency-mocking instructions with concise Run Summary (2 units, 1 succeeded, 1 failed) and explanatory narrative about DAG-based build order and dependency handling; removes error diagnostics and mock_outputs example in favor of higher-level behavior description

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

• docs: Improving Run Queue docs #4272 — Updates documentation about Terragrunt's DAG-based run ordering and dependency/error handling, aligning with this Quick Start guide revision.

Suggested reviewers

• denis256
• yhakbar

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The description uses the required template structure but contains minimal substantive content; most sections are left as placeholder examples (Fixes #000, Added/Removed/Updated [X]) and checkboxes remain unchecked.	Complete the description with specific details: the actual issue number being fixed, a clear summary of the documentation changes made, and mark completed TODO items to clarify work status and release impact.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: updating the quick-start guide documentation with corrected dependency error details, which aligns with the file modification shown in the summary.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e0a2f68 and 2d64dc1.

📒 Files selected for processing (1)

• docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx

🧰 Additional context used

📓 Path-based instructions (1)

docs-starlight/**/*.md*

⚙️ CodeRabbit configuration file

Review the documentation for clarity, grammar, and spelling. Make sure that the documentation is easy to understand and follow. There is currently a migration underway from the Jekyll based documentation in docs to the Starlight + Astro based documentation in docs-starlight. Make sure that the docs-starlight documentation is accurate and up-to-date with the docs documentation, and that any difference between them results in an improvement in the docs-starlight documentation.

Files:

• docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx

🔇 Additional comments (1)

docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx (1)

404-415: LGTM! The updated error output improves documentation accuracy.

The new error output and Run Summary are more concise and align well with the PR objective to show the actual error output from the dependency example. The content maintains clarity while providing:

• Helpful guidance (suggestion to use dependencies block)
• Clear error diagnostics (unknown variable message)
• Summary of execution results (2 units, 1 succeeded, 1 failed)

The changes successfully replace verbose diagnostics with a clearer, more accurate representation of what users will actually see, while maintaining the tutorial's educational flow.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx (1)

377-389: Fix indentation inconsistency in the code example.

Line 379 uses single-space indentation while the rest of the file's HCL examples use two-space indentation (see lines 249-251, 260-262, etc.).

📝 Proposed fix

 # bar/terragrunt.hcl
 terraform {
-  source = "../shared"
+   source = "../shared"
 }

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e0a2f68 and 2d64dc1.

📒 Files selected for processing (1)

• docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx

🧰 Additional context used

📓 Path-based instructions (1)

docs-starlight/**/*.md*

⚙️ CodeRabbit configuration file

Review the documentation for clarity, grammar, and spelling. Make sure that the documentation is easy to understand and follow. There is currently a migration underway from the Jekyll based documentation in docs to the Starlight + Astro based documentation in docs-starlight. Make sure that the docs-starlight documentation is accurate and up-to-date with the docs documentation, and that any difference between them results in an improvement in the docs-starlight documentation.

Files:

• docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx

🔇 Additional comments (1)

docs-starlight/src/content/docs/01-getting-started/01-quick-start.mdx (1)

404-415: LGTM! The updated error output improves documentation accuracy.

The new error output and Run Summary are more concise and align well with the PR objective to show the actual error output from the dependency example. The content maintains clarity while providing:

• Helpful guidance (suggestion to use dependencies block)
• Clear error diagnostics (unknown variable message)
• Summary of execution results (2 units, 1 succeeded, 1 failed)

The changes successfully replace verbose diagnostics with a clearer, more accurate representation of what users will actually see, while maintaining the tutorial's educational flow.