User Documentation Alcuni aspetti da tenere presenti quando si invia un articolo a questa documentazione:
- Immagini: evitare screenshot in formato jpg, sfocati e un po' troppo piccoli. Sostituirli con immagini png più grandi. Rendere tutti gli screenshot larghi tra 1500 e 2500 pixel, sapendo che porteranno alla creazione di un insieme di immagini responsive in diverse dimensioni e formati, incluso webp. Vedi i nostri suggerimenti per screenshot migliori.
- Titoli: utilizzare i titoli invece di righe in grassetto. Queste righe in grassetto non creano una struttura semantica del documento e verrebbero segnalate dal Joomla Accessibility Checker. Disporle in una gerarchia logica: non passare da H2 a H4 saltando H3. Non usare H1 negli articoli, poiché ci sarà un solo H1 nella pagina: il titolo dell'articolo.
- Clicca: usare questo termine solo per il clic su un pulsante. Non per selezionare qualcosa da una lista di opzioni: in quel caso andrebbe usato "Seleziona". Originariamente la parola "Clicca" viene usata per le azioni del mouse e non è appropriata per gli utenti che usano tastiera o touchpad.
- Punteggiatura: abbiamo molte liste di termini che iniziano con una parola o un gruppo di parole in grassetto seguito da due punti o da un punto, a volte all'interno del gruppo in grassetto e a volte all'esterno. Per coerenza non mettere in grassetto i due punti o il punto. Come nella lista che stai leggendo ora.
- Parole da tenere d'occhio: vedi questa lista nel Manuale per sviluppatori. Ad esempio, presta attenzione a back-end, front-end e directory, parole presenti nella colonna Parole inaccettabili dell'elenco Parole da tenere d'occhio.
- Manager: questo termine era spesso usato in Joomla 3, come in Gestione articoli, Gestione menu o Gestione utenti. È praticamente scomparso da Joomla 4 in poi. Ora si usa qualunque cosa compaia nella barra del titolo di una pagina dell'amministrazione, ad esempio la pagina lista Articoli, la pagina lista Menu: voci o la pagina lista Moduli (Sito).
- Uso coerente di in o su: come in "Clicca sul pulsante Aiuto nella/sulla Barra degli strumenti" o "nella/sulla Pagina". Puoi considerare queste posizioni come contenitori, il che renderebbe in la parola preferita da usare.