---
title: documentation-index-section-ambiguous
description: Reports an Index Document that contains the configured Index Section heading more than once.
---

[← All Rules](/rules/)

## What it does

Reports the second occurrence when the configured semantic heading identifies multiple sections in one Index Document.

## Why it matters

Presswork needs exactly one section to own the directory's inventory.

## Examples

### Non-passing

```md title="AGENTS.md"
# Source Of Truth Map

- [Guide](docs/guide.md) — Load for contributor guidance.

# Source Of Truth Map
```

### Passing

```md title="AGENTS.md"
# Source Of Truth Map

- [Guide](docs/guide.md) — Load for contributor guidance.
```

## When it applies

This Rule belongs to the configurable `documentation-indexes` group and runs for enabled Index Policies. The configured heading text is matched semantically, independent of heading depth.

## References

See [Presswork Configuration](/configuration/#indexes) for the configured heading and [`src/check/evaluate-index.ts`](https://github.com/evilkiwi/presswork/blob/main/src/check/evaluate-index.ts) for section selection.