docs: re-add troubleshooting section to docs/metrics.md

[MegaRedHand]

#109 deleted the metrics readme, which had a troubleshooting section that was useful. This PR re-adds that section in docs/metrics.md.

[github-actions]

🤖 Kimi Code Review

Review of PR #129 (docs/metrics.md)

The change is purely documentation and looks correct. The troubleshooting note provides useful guidance for Docker Desktop on macOS users who might encounter networking issues with the host network mode.

No code correctness, security, or performance issues identified.

---

Automated review by Kimi (Moonshot AI) · custom prompt

[github-actions]

🤖 Codex Code Review

Looks good. This PR only updates documentation in docs/metrics.md and doesn’t touch consensus, state transition, or cryptographic logic, so there are no correctness, security, performance, or Rust concerns to flag.

Minor notes:

• docs/metrics.md: The new troubleshooting section is clear and scoped. No changes needed.

If you want line-precise references, I can annotate with exact line numbers once the file is in the repo view, but given the diff size this is fine.

---

Automated review by OpenAI Codex · custom prompt

[github-actions]

🤖 Claude Code Review

PR Review: Re-add Troubleshooting Section to docs/metrics.md

Summary

This PR restores a troubleshooting section that was accidentally removed in PR 109. The changes are documentation-only and add helpful guidance for MacOS users running lean-quickstart with Docker Desktop.

Review Findings

✅ Overall Assessment: Approved

This is a straightforward documentation improvement with no code changes. The content is helpful and appropriate.

Specific Observations

Documentation Quality:

1. The troubleshooting section is well-placed at the end of the metrics documentation
2. The issue being addressed (Docker host networking on MacOS) is a legitimate problem that users commonly encounter with Docker Desktop
3. The solution provided (enabling host networking in Docker Desktop settings) is correct and links to official Docker documentation

Writing Quality:

• Clear and concise explanation
• Properly formatted markdown
• Appropriate use of heading hierarchy (## for Troubleshooting, ### for platform-specific issue)

Technical Accuracy:

• The explanation is technically correct: Docker Desktop on MacOS doesn't support host networking mode by default (unlike Linux)
• The linked documentation reference is valid and points to the correct Docker Enterprise settings

Minor Suggestions

No blocking issues, but one optional improvement:

Optional Enhancement:
Consider adding a note about alternative approaches if users don't have Docker Desktop Enterprise or cannot enable the setting. For example:

If you cannot enable host networking, you may need to use port mapping instead. 
Consult the lean-quickstart documentation for alternative configurations.

However, this is not necessary for approval - the current content adequately addresses the primary use case.

---

Recommendation: LGTM ✅

This PR successfully restores valuable troubleshooting documentation that will help MacOS users get started with the project more easily. No changes required.

---

Automated review by Claude (Anthropic) · custom prompt

[greptile-apps]

Greptile Overview

Greptile Summary

This PR restores the troubleshooting section that was removed when PR #109 deleted the metrics/README.md file. The section documents a MacOS-specific issue with Docker Desktop's host networking mode and provides a solution.

• Re-adds troubleshooting documentation for Docker Desktop on MacOS
• Content is identical to what was previously in metrics/README.md
• Properly references lean-quickstart, which is already mentioned earlier in the document
• Includes a valid link to Docker Desktop documentation

Confidence Score: 5/5

• This PR is completely safe to merge with no risk
• This is a documentation-only change that restores previously deleted content. The troubleshooting section is useful, accurate, and properly formatted. No code changes are involved.
• No files require special attention

Important Files Changed

Filename	Overview
docs/metrics.md	Re-adds troubleshooting section for Docker Desktop on MacOS that was previously deleted in PR #109

_{Last reviewed commit: d353450}