Descarregar sites que utilizam Haddock

Sobre Haddock

O autor de uma biblioteca Haskell escreve a documentação como anotações dentro dos comentários do código, corre uma compilação e publica aquilo que essa compilação produziu. As páginas que ficam depois no servidor web são HTML estático vulgar, e é precisamente por isso que Haddock chega sequer a ser reconhecível. A nossa impressão digital corresponde à estrutura e às convenções de marcação do resultado gerado, não a um serviço em execução, pelo que uma correspondência descreve o que um domínio publica e não a forma como esse domínio está alojado.

A distinção pesa logo na leitura do número. Em outubro de 2026, o número de domínios onde detetamos Haddock é de 1, e o valor é um limite inferior, não uma medição de quanta documentação Haskell existe na web pública. A documentação gerada é muitas vezes servida a partir de um punhado de polos centrais, integrada num site de documentação mais vasto com tema próprio, ou publicada em caminhos profundos que um rastreio das páginas de entrada de um domínio nunca alcança. Uma substituição de tema ou um passo de pós-processamento pode apagar os marcadores em que nos apoiamos sem tocar na ferramenta que está por baixo.

Tudo o que é estrutural na ferramenta aponta para uma cadeia de compilação e não para um produto. O projeto é mantido sob a alçada de Haskell.org, distribuído com licença BSD e escrito no próprio Haskell, pelo que o gerador de documentação e a linguagem que ele documenta avançam no mesmo ciclo de lançamentos. Existe desde 2002 e vem incluído numa instalação padrão de Haskell, o que torna o seu uso um valor por omissão e não uma decisão, e essa é uma diferença real face a um componente que alguém avaliou e escolheu. A versão que observámos é 2.14.3, e com esta dimensão um facto de versão descreve a compilação concreta que gerou aquelas páginas em particular, não uma distribuição por um parque instalado.

Para quem investiga, a pergunta útil não é se um determinado domínio corre Haddock, porque uma só consulta responde a isso num instante. A lista justifica o descarregamento quando a pergunta corre no sentido inverso: que domínios, em todo o rastreio, chegam sequer a publicar resultados da cadeia de ferramentas de Haskell. Responder a isso com consultas domínio a domínio obriga a conhecer os domínios de antemão, e os interessantes são em regra aqueles que ninguém se lembrou de verificar. Uma impressão digital deste género na categoria Documentation é um substituto viável para encontrar repositórios de pacotes, páginas de grupos universitários e documentação interna de bibliotecas que ficou discretamente pública, e o conjunto de dados devolve-os a todos numa só passagem, cada um com o resto da pilha detetada na mesma linha.