Enkele aandachtspunten bij het indienen van een artikel voor deze documentatie:
- Afbeeldingen: vermijd schermafbeeldingen in jpg-formaat, wazig en een beetje te klein. Vervang ze door grotere png-afbeeldingen. Maak alle schermafbeeldingen tussen 1500 en 2500 pixels breed, wetende dat deze zullen leiden tot het maken van een set responsieve afbeeldingen in verschillende formaten, inclusief webp. Bekijk onze tips voor betere schermafbeeldingen.
- Koppen: gebruik koppen in plaats van vetgedrukte regels. Die vetgedrukte regels creëren geen semantische documentstructuur en zouden gemarkeerd worden door de Joomla Toegankelijkheidscontrole. Rangschik ze in een logische hiërarchie: spring niet van H2 naar H4 en sla H3 niet over. Gebruik geen H1 in uw artikelen, aangezien er maar één H1 op de pagina zal zijn: de titel van het artikel.
- Klik: gebruik dit alleen voor het klikken op een knop. Niet voor het selecteren van iets uit een lijst met opties: daar moet "Selecteer" gebruikt worden. Oorspronkelijk wordt het woord "Klik" gebruikt voor muisacties en is het niet geschikt voor gebruikers van toetsenbord of touchpad.
- Interpunctie: we hebben veel lijsten met termen die beginnen met een vetgedrukt woord of woordgroep gevolgd door een dubbele punt of punt, soms binnen de vetgedrukte groep en soms erbuiten. Voor consistentie, maak de dubbele punt of punt niet vet. Zoals in de lijst die u nu leest.
- Woorden om op te Letten: zie deze lijst in de Developers Manual. Let bijvoorbeeld op back-end, front-end en directory, woorden die in de kolom Onacceptabele Woorden van Woorden om op te Letten staan.
- Manager: deze term werd vaak gebruikt in Joomla 3, zoals in Artikelbeheer, Menubeheer of Gebruikersbeheer. Het is grotendeels verdwenen uit Joomla 4+. Gebruik nu wat er in de titelbalk van een beheerderspagina staat, bijvoorbeeld de lijstpagina Artikelen, Menu's: lijstpagina Items of lijstpagina Modules (Website).
- Consistent gebruik van in of op: zoals in "Selecteer de knop Help in/op de Werkbalk" of "in/op de Pagina". U kunt deze locaties zien als containers, waardoor in het voorkeurswoord zou zijn om te gebruiken.