User Documentation Algumas questões a ter em conta ao submeter um artigo para esta documentação:
- Imagens: evite capturas de ecrã em formato jpg, desfocadas e demasiado pequenas. Substitua-as por imagens png maiores. Faça todas as capturas de ecrã com uma largura entre 1500 e 2500 pixels, sabendo que irão originar a criação de um conjunto de imagens responsivas em diferentes tamanhos e formatos, incluindo webp. Consulte as nossas dicas para melhores capturas de ecrã.
- Cabeçalhos: utilize cabeçalhos em vez de linhas a negrito. Essas linhas a negrito não criam uma estrutura semântica do documento e seriam assinaladas pelo Verificador de Acessibilidade do Joomla. Organize-os numa hierarquia lógica: não salte de H2 para H4, ignorando o H3. Não utilize H1 nos seus artigos, pois haverá apenas um H1 na página: o título do artigo.
- Clicar: utilize apenas para clicar num botão. Não para selecionar algo de uma lista de opções: nesse caso deve utilizar-se "Selecionar". Originalmente, a palavra "Clicar" é usada para ações com o rato e não é apropriada para utilizadores de teclado ou touchpad.
- Pontuação: temos muitas listas de termos que começam com uma palavra ou grupo de palavras a negrito, seguida de dois pontos ou ponto final, por vezes dentro do grupo a negrito e por vezes fora dele. Para consistência, não coloque os dois pontos ou o ponto final a negrito. Como na lista que está a ler atualmente.
- Palavras a ter em atenção: consulte esta lista no Manual de Programadores. Por exemplo, tenha atenção a back-end, front-end e diretório, palavras que constam na coluna de Palavras Inaceitáveis da lista de Palavras a ter em Atenção.
- Gestor: este termo era frequentemente usado no Joomla 3, como em Gestor de Artigos, Gestor de Menus ou Gestor de Utilizadores. Praticamente desapareceu no Joomla 4+. Utilize agora o que estiver na barra de título de uma página da área administrativa, por exemplo página de lista de Artigos, página de lista de Menus — Itens ou página de lista de Módulos (Sítio).
- Uso consistente de em ou na/no: como em "Selecione o botão Ajuda na Barra de Ferramentas" ou "na Página". Pode ver estes locais como contentores, o que tornaria em a palavra preferida a utilizar.