20-docs-nobody-could-find

Os docs que ninguém encontrava.

Passei semanas em documentação bilingue para três SDKs open source. Estrutura limpa, exemplos de código, recipes, glossário. Hospedados grátis no GitHub Pages, domínio próprio, tudo verde.

Depois abri o Google Search Console.

Mal indexados. Algumas páginas apareciam em "discovered, not indexed". Outras diziam "alternate page with proper canonical tag" — quando não havia alternate nenhuma. Pesquisas por termos que deviam dar match nos docs devolviam concorrentes, threads irrelevantes do Stack Overflow, qualquer coisa menos as minhas páginas.

Docs que não rankeiam são um repo privado com domínio. Se um developer pesquisa no Google o problema que a minha biblioteca resolve e nunca encontra os meus docs, a minha biblioteca não existe para ele.

Movi os docs de GitHub Pages para AWS S3 + CloudFront. As razões eram específicas, não vagas:

→ Controlo do sitemap.xml servido e linkado a partir do robots.txt.
→ Controlo sobre response headers — particularmente Cache-Control, X-Robots-Tag, e os alternates de língua.
→ Origin separado por subpath de língua, para que canonical e hreflang ficassem inequívocos.
→ TTFB mais rápido e serving estável, que o Google premeia.

Em quatro semanas, a contagem de páginas indexadas triplicou. O Search Console começou a mostrar impressions para os termos para os quais eu escrevia.

Distribuição faz parte do produto. Especialmente para open source. Especialmente solo. Especialmente quando compete contra incumbentes cujos nomes já são donos do namespace de pesquisa.

Esta peça fecha a série de 9 partes sobre open source. O blog continua — em tech.bilouro.com — com pieces mais longas sobre o mesmo craft, evergreen, indexáveis.

Onde é que vivem os teus docs? E já verificaste o Search Console?

Sítios: eupago.bilouro.com · vendus.bilouro.com · xmldiffreport.bilouro.com

P.S. Obrigado por leres a série. As pieces longas continuam no blog.

#OpenSource #Python #DeveloperExperience