Skip to content

Commit f2e97e0

Browse files
sir-sigurdclaude
andcommitted
Tighten TOC link suppressions and fix two retargetable entries
- Retarget Troubleshooting and Terraform Commands Reference to the real sections; only the five entries needing cross-doc decisions (#95) stay. - Switch the README disable block to per-line disables so a TOC entry added later still gets dead-anchor checking. - Reword the TODO: #95 tracks the broken links themselves, not a restructure. - Indent the suppression comments under the preceding list item so the TOC and checklists render as single lists (an unindented HTML comment between bullets splits the list). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 9bea365 commit f2e97e0

2 files changed

Lines changed: 13 additions & 10 deletions

File tree

OPERATIONS.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,16 +20,16 @@ This document provides comprehensive operational procedures for cloud teams mana
2020

2121
- [ ] Backup verification (10 min) - [Instructions](#backup-verification-10-minutes)
2222
- [ ] Security updates (15 min) - [Instructions](#security-updates-15-minutes)
23-
<!-- TODO: no "Capacity review" section exists yet; see https://github.com/quiltdata/iac/issues/95 -->
24-
<!-- markdownlint-disable-next-line link-fragments -->
23+
<!-- TODO: no "Capacity review" section exists yet; see https://github.com/quiltdata/iac/issues/95 -->
24+
<!-- markdownlint-disable-next-line link-fragments -->
2525
- [ ] Capacity review (10 min) - [Instructions](#capacity-monitoring)
2626

2727
### Monthly Checklist
2828

2929
- [ ] Capacity planning (20 min) - [Instructions](#capacity-planning-20-minutes)
3030
- [ ] Cost review (15 min) - [Instructions](#cost-optimization-recommendations)
31-
<!-- TODO: no "Security audit" section exists yet; see https://github.com/quiltdata/iac/issues/95 -->
32-
<!-- markdownlint-disable-next-line link-fragments -->
31+
<!-- TODO: no "Security audit" section exists yet; see https://github.com/quiltdata/iac/issues/95 -->
32+
<!-- markdownlint-disable-next-line link-fragments -->
3333
- [ ] Security audit (30 min) - [Instructions](#security-audit)
3434

3535
## Installation Procedures

README.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,20 @@ Deploy and maintain Quilt stacks with Terraform using this comprehensive Infrast
1010
- [Prerequisites](#prerequisites)
1111
- [Quick Start](#quick-start)
1212
- [Rightsize Your Search Domain](#rightsize-your-search-domain)
13-
<!-- TODO(#95): the entries below point to README sections that don't exist yet;
14-
the table-of-contents restructure is tracked separately. -->
15-
<!-- markdownlint-disable link-fragments -->
13+
<!-- TODO: the five entries below link to README sections that don't exist
14+
yet; see https://github.com/quiltdata/iac/issues/95 -->
15+
<!-- markdownlint-disable-next-line link-fragments -->
1616
- [Database Configuration](#database-configuration)
17+
<!-- markdownlint-disable-next-line link-fragments -->
1718
- [Network Configuration](#network-configuration)
19+
<!-- markdownlint-disable-next-line link-fragments -->
1820
- [CloudFormation Parameters](#cloudformation-parameters)
21+
<!-- markdownlint-disable-next-line link-fragments -->
1922
- [Complete Variable Reference](#complete-variable-reference)
23+
<!-- markdownlint-disable-next-line link-fragments -->
2024
- [Deployment Examples](#deployment-examples)
21-
- [Troubleshooting](#troubleshooting)
22-
- [Terraform Commands Reference](#terraform-commands-reference)
23-
<!-- markdownlint-enable link-fragments -->
25+
- [Troubleshooting](#troubleshooting-common-issues)
26+
- [Terraform Commands Reference](#terraform-cheat-sheet)
2427

2528
## Cloud Team Operations Guide
2629

0 commit comments

Comments
 (0)