uttrflow / uttrflow/uttrflow-swift
Docs/README.md does not list soak.md or ui-tests.md, and no document links to either
- Lenguaje dominante
- Swift
- Estrellas
- 4
- Forks
- 17
- Merge medio
- 4 h 27 min
- PR fusionados (30 d)
- 286
Descripción
## What happens
`Docs/README.md` indexes 88 of the 90 files in `Docs/`. The two it leaves out, `Docs/soak.md` (how to run `make soak`) and `Docs/ui-tests.md` (how to run `make uitest`), are not linked from any other Markdown file in the repository (`git grep -l 'soak.md\|ui-tests.md' -- '*.md'` finds nothing), so the only way to find them is to list the directory.
`Scripts/docs_audit.sh` checks that links resolve, but not that every document is reachable from the index.
## Why it matters
`make soak` and `make uitest` are in `make help`, and these are the pages that explain what they need (hours of running, a windowing session) before somebody starts one.
## Acceptance criteria
- Both documents are listed in `Docs/README.md` under a fitting heading.
- `Scripts/docs_audit.sh` gains a check that every `Docs/*.md` other than `Docs/README.md` is linked from `Docs/README.md`, and fails naming the file when one is not.
- `make docs-audit` passes; say in the pull request that removing one of the new index lines makes it fail.
## Where to start
- `Docs/README.md`, `Scripts/docs_audit.sh` section 3 (relative links), which already parses links.
- Read [CONTRIBUTING.md](https://github.com/uttrflow/uttrflow-swift/blob/main/CONTRIBUTING.md) first, and say on this issue that you are taking it.
- Before pushing, run `make verify` (with `DEVELOPER_DIR` pointing at Xcode 26.6 or later). It is the same command CI runs.
**Size:** S, about 1 hour.
Guía de contribución
Línea de trabajo
Lee CONTRIBUTING.md primero, luego inspecciona Docs/README.md y la sección 3 de Scripts/docs_audit.sh, que ya analiza enlaces relativos. Añade los dos enlaces a documentos y la comprobación faltante de cobertura del índice, luego ejecuta make docs-audit y make verify; estará terminado cuando ambos archivos estén indexados y eliminar una línea del índice haga que la auditoría falle indicando ese archivo.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- markdown, shell
- Área
- build-system, documentation
- Tipo de issue
- Documentación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Estado de actividad
- Activo
- Claridad
- Bien especificado
- Aptitud para principiantes
- 88/100