---
title: "Reduzindo em 95% o tamanho da documentação DocC"
description: "Um único build setting corta de 900 MB para 45 MB o site de documentação de projetos SwiftUI."
canonical: "https://ronanrodrigo.dev/notes/docc-documentacao-95-menor"
markdown: "https://ronanrodrigo.dev/notes/docc-documentacao-95-menor.md"
last-updated: "2026-10-05"
---
## Reduzindo em 95% o tamanho da documentação DocC

O DocC gera sites de documentação enormes em projetos pesados em SwiftUI porque inclui por padrão membros herdados de protocolos e modifiers do SwiftUI.

- **O problema**: o DocC cria páginas separadas para cada modifier herdado, gerando HTML e JSON. O KeyboardKit tinha 83 views com mais de 500 páginas herdadas cada, somando mais de 160 mil arquivos; um único `Keyboard.ButtonKey` gerava 929 páginas.
- **A solução**: definir `DOCC_SKIP_SYNTHESIZED_MEMBERS=YES` no Xcode ou passar o flag ao `xcodebuild docbuild`.
- **O que permanece**: tipos, membros e documentação definidos explicitamente continuam no site.
- **Resultado**: de cerca de 900 MB para 45 MB sem remover nenhuma API escrita à mão.

[Acesse a fonte original](https://danielsaidi.com/blog/2026/10/01/how-i-reduced-the-size-of-my-docc-documentation-with-95)