Números e unidades
Escreva números do mesmo jeito em toda página: quando escrever por extenso, separadores, unidades de medida, datas, horários e moeda.
Escreva de zero a nove por extenso
Escreva zero até nove por extenso, e 10 em diante com algarismos.
- Correto:
Crie três regras. - Correto:
A conta permite 100 buckets.
Três casos usam algarismo em qualquer valor: uma medida, uma versão e tudo o que o leitor digita ou lê na tela. Defina o TTL em 5 segundos, não cinco segundos.
Use vírgula para decimais e ponto para milhares
| Regra | Exemplo |
|---|---|
| Vírgula como separador decimal | 9,5, 3,14159 |
| Ponto para milhares | 10.000, 25.456.990 |
| Zero antes da vírgula abaixo de um | 0,5, nunca ,5 |
O inglês inverte os dois separadores e escreve 10,000 e 9.5. Um número copiado de um par para o outro sem conversão fica errado em um dos idiomas, e essa é a falha mais comum em uma tradução.
Escreva a unidade junto do número
- Coloque um espaço entre o algarismo e a unidade:
20 MB,60 segundos. - Use hífen quando a medida modifica um substantivo em inglês:
a 60-second TTL. - Abrevie apenas ao lado de um número, e nunca coloque ponto depois da abreviação:
20 MB, não20 MB.nemvinte MB.
Todo valor em uma tabela carrega sua unidade. Uma célula com 100 deixa o leitor escolhendo entre megabytes, segundos e requisições. Referência trata um limite sem unidade como um fato incompleto.
MB e MiB são números diferentes. Escreva a unidade que o produto declara e nunca converta entre as formas decimais (kB, MB, GB) e binárias (KiB, MiB, GiB). O mesmo vale para taxas: Gbps conta bits e MB/s conta bytes, oito vezes de diferença, então mantenha a forma que o produto usa.
Um limite é exato e nunca é arredondado. Arredonde apenas um número ilustrativo, e marque: cerca de 200 ms.
Use traço médio em um número negativo
Escreva –40 com traço médio, não com hífen. A regra vale para a prosa: em código, comandos e qualquer valor que o leitor copia, mantenha o hífen ASCII — um –40 colado não é interpretado. Pontuação cobre as demais regras de traços.
Escreva um ordinal sem sufixo além do número
Escreva primeiro e segundo por extenso. Em algarismo, escreva 1º, nunca 1ºmente.
Formate uma data apenas onde uma data cabe
Datas aparecem em changelogs e em nenhum outro lugar, o que Escolha de palavras declara como regra. Uma data em qualquer outro lugar envelhece a página.
Onde a data é permitida, escreva o mês por extenso: 10 de julho de 2026. O inglês usa a ordem mês, dia, ano: July 10, 2026.
- Incorreto:
10/07/2026 - Correto:
10 de julho de 2026
Uma data numérica é lida como mês primeiro nos Estados Unidos e como dia primeiro em quase todo o resto, então ela significa duas coisas ao mesmo tempo.
Escreva um horário no formato de 24 horas
Em português, use o formato de 24 horas: 10:45 e 18:30. Em inglês, escreva AM e PM em maiúsculas, com um espaço antes: 10:45 AM.
Não escreva 24/7. Escreva o tempo todo ou nomeie a disponibilidade real.
Formate moeda apenas na página de pricing
Um preço, uma cota vendida por unidade e uma métrica de cobrança vivem só na página de pricing. Referência proíbe repetir qualquer um deles em uma página de produto.
Onde o valor é permitido, o símbolo vem antes do número, sem espaço: $1.000.