Siga o Olhar Digital no Google Discover
Para ajudar seus desenvolvedores e, principalmente, os recém-chegados, o Google publicou um guia de estilo com diretrizes para orientar as pessoas na hora de escrever a documentação para projetos relacionados à empresa.
Ofertas
Por: R$ 36,21
Por: R$ 24,96
Por: R$ 9,90
Por: R$ 5,86
Por: R$ 113,70
Por: R$ 6,90
Por: R$ 37,92
Por: R$ 22,59
Por: R$ 59,95
Por: R$ 3.099,00
Por: R$ 3.324,00
Por: R$ 799,00
Por: R$ 241,44
Por: R$ 388,78
Por: R$ 2.159,00
Por: R$ 188,99
Por: R$ 45,00
Por: R$ 379,00
Por: R$ 1.239,90
Por: R$ 943,20
Por: R$ 798,99
Por: R$ 199,00
Por: R$ 476,10
Por: R$ 1.139,05
Por: R$ 949,00
Por: R$ 119,90
Por: R$ 398,99
Por: R$ 79,90
Por: R$ 199,90
Este é o mesmo guia de estilo que o Google usa internamente para escrever a documentação de seus próprios projetos e ele conta com desde uma lista de ortografia para o vocabulário do setor, como “data center” ao invés de “datacenter”, até orientações de como escrever bons comentários do código API.
“Este guia é um documento vivo; ele muda ao longo do tempo, e, quando ele muda, geralmente não alteramos a documentação publicada anteriormente para coincidir. Nós nos esforçamos por consistência, na medida do possível, mas a qualquer momento certamente haverá partes de nossa documentação que não combinam com este guia de estilo. Em caso de dúvida, siga este guia em vez de imitar documentos existentes”, afirma a empresa. O Google, no entanto, ressalta que o guia não fornece aconselhamento jurídico.