Documentation/pt-br/Estilo

Apresentamos abaixo algumas regras de estilo para as traduções de manuais e da Ajuda do LibreOffice.

Geral
Mesmo sendo uma tradução, algumas indicações sobre o estilo da documentação técnica são válidas.

Use frases curtas, com palavras e frases fáceis de enteder. Seja conciso e claro. Idealmente:


 * Parágrafos não devem ultrapassar seis frases.
 * Frases devem conter no máximo 20 palavras, ocasionalmente 25 palavras.

Escreva na voz ativa ou no imperativo, utilize a voz passiva somente se necessário ou apropriado. Por exemplo, Faça isso, e então faça aquilo.

Utilize o Presente do Indicativo, use o Futuro somente se necessário ou apropriado. Tente fazer suas descrições atemporais. Por exemplo, escreva 'A caixa de diálogo abre-se' invés de 'A caixa de diálogo será aberta'. Somente utilize o futuro quando um evento ocorre necessariamente após outro. Por exemplo, 'Se utilizar estilos, seus documentos serão mais fáceis de atualizar'.

Evite a terceira pessoa, por exmeplo, o usuário. Utilize a forma 'você' ou o Imperativo.

Evite o excesso de Você. Use o sujeito oculto. Veja exemplos mais embaixo.

Nunca use gíria.

Use uma linguagem neutra sem menção de gênero. Não utilize coisas estranhas como ele/ela

Não utilize contrações. Por exemplo, pra no lugar de para. Tá no lugar de está.

Muito menos contrações de menssageria de celulares: 'vc', 'pq', 'blz'.

Gerúndio em títulos
Evitar ao máximo. A regra é usar o INFINITIVO do verbo. Exemplos:

YOU -> Você e sujeito oculto
Ocorre frequentemente o emprego do pronome YOU na frase, gerando repetição. Se no inglês isso é aceitável, no português não fica bem e a recomendação é empregar o sujeito oculto.

Where you can -> Para
'Where you can' ou 'Where the user can' pode ser substituído pela preposição para

Please -> (nada)
'Please enter your name' pode ser traduzido por Entre com seu nome ou  Insira seu nome, evitando de utilizar 'Por favor'