User Documentation Este glossário define termos e expressões padronizados usados em toda a documentação e nos tutoriais, para manter a terminologia e a escolha de palavras consistentes entre os autores.
Log in vs. Login
A regra: login (uma palavra) é um substantivo ou adjetivo; log in (duas palavras) é o verbo.
- Substantivo/adjetivo: "a tela de login", "o botão de login", "suas credenciais de login", "um login mal sucedido" — em qualquer lugar em que esteja nomeando algo ou descrevendo outro substantivo, é uma palavra.
- Verbo: "por favor, faça login", "faça login com seu email", "você precisa fazer login primeiro" — em qualquer lugar em que esteja descrevendo a ação de efetuar login, são duas palavras ("log in", no original em inglês), que em português se traduz como "fazer login".
Exemplo: "Vá até a tela de login, depois faça login e, em seguida, clique no botão de login."
O mesmo padrão se aplica a logout/log out: "o botão de logout" (substantivo/adjetivo, uma palavra) vs. "faça logout quando terminar" (verbo, "log out" no original).
Visualizar o site
Use "visualizar o site" para orientar um usuário que está trabalhando no backend a abrir o frontend e verificar o resultado das alterações que acabou de fazer.
A ação usa o link Visualizar site no cabeçalho do backend, que abre o frontend em uma nova aba do navegador. Isso estabelece um fluxo de trabalho com duas abas: o backend em uma aba, o frontend em outra, com o usuário alternando entre elas para verificar os resultados. Apresente esse padrão logo no início — na introdução do tutorial — para que os usuários fiquem à vontade para alternar entre abas ao longo dos tutoriais seguintes.
Exemplo: "No cabeçalho do backend, clique em Visualizar site para abrir o frontend em uma nova aba. Mantenha as duas abas abertas e alterne entre elas conforme avança neste tutorial."
Menu do Administrador
O menu de navegação do lado esquerdo na área administrativa do site é chamado de Menu do Administrador.
Frontend / Backend
Use "frontend" para se referir ao site voltado para o público, e "backend" para se referir à área administrativa. Esses termos correspondem ao que a própria documentação do Joomla chama de "o Site" e "o Administrador", respectivamente.
Prefira frontend/backend nas instruções dos tutoriais, especialmente ao orientar o leitor a fazer login em um ou outro — soa mais natural como um par contrastante. Use Site/Administrador apenas ao fazer referência às próprias configurações ou rótulos de menu oficiais do Joomla, onde esses termos exatos aparecem (por exemplo, Módulos do Site vs. Módulos Administrativos).
Alça de arraste
Use "alça de arraste" para o ícone (três pontos verticais) que aparece nas visualizações de lista do backend para reordenar itens — artigos, itens de menu, módulos, categorias e listas semelhantes aceitam esse recurso. Ele aparece após clicar no ícone de seta para cima/baixo no cabeçalho da coluna relevante, e somente quando a lista está filtrada ou ordenada de forma que a reordenação seja possível.
O próprio código-fonte do Joomla se refere a isso internamente como "sortable handler" (classe CSS sortable-handler, ícone icon-menu), mas "alça de arraste" é o termo usado na documentação e nos fóruns da comunidade Joomla, sendo o termo mais reconhecível para os leitores.
Exemplo: "Clique na alça de arraste ao lado de Sidebar Announcement e arraste-a para o topo da lista."