diff options
| author | DanConwayDev <DanConwayDev@protonmail.com> | 2026-01-09 21:41:45 +0000 |
|---|---|---|
| committer | DanConwayDev <DanConwayDev@protonmail.com> | 2026-01-09 21:41:45 +0000 |
| commit | 6a8346441ea605248e09858d0e6b9096a1c87259 (patch) | |
| tree | a24768a427f1d4b7e9adaff2b37f1385440f1c29 /docs/how-to/README.md | |
| parent | 5fed2e2f32cfb15fff042a39f3ac82abe8948ca0 (diff) | |
docs: add production sync testing guide and log sanitizer script
Add infrastructure for iterative debugging of sync against production data:
- scripts/sanitize-logs.sh: Truncates verbose log lines for LLM analysis
- docs/how-to/production-sync-testing.md: Step-by-step guide for testing
sync against real relays, identifying issues, and improving logging
Diffstat (limited to 'docs/how-to/README.md')
| -rw-r--r-- | docs/how-to/README.md | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/how-to/README.md b/docs/how-to/README.md index ed5f014..ba58c08 100644 --- a/docs/how-to/README.md +++ b/docs/how-to/README.md | |||
| @@ -36,6 +36,18 @@ How-to guides are **recipes** that show you how to solve specific problems or ac | |||
| 36 | 36 | ||
| 37 | --- | 37 | --- |
| 38 | 38 | ||
| 39 | ### [Test Sync Against Production Data](production-sync-testing.md) | ||
| 40 | **Problem:** Debug and improve sync using real-world data | ||
| 41 | **Difficulty:** Intermediate | ||
| 42 | |||
| 43 | **You'll learn:** | ||
| 44 | - Run sync against production relays | ||
| 45 | - Sanitize logs for LLM analysis | ||
| 46 | - Identify common issues and patterns | ||
| 47 | - Iteratively improve sync behavior | ||
| 48 | |||
| 49 | --- | ||
| 50 | |||
| 39 | ## Planned How-To Guides | 51 | ## Planned How-To Guides |
| 40 | 52 | ||
| 41 | ### Deploy ngit-grasp | 53 | ### Deploy ngit-grasp |