User Documentation Deze woordenlijst definieert gestandaardiseerde termen en formuleringen die worden gebruikt in documentatie en tutorials, om terminologie en woordkeuze consistent te houden tussen auteurs.
Log in versus Login
De regel: login (één woord) is een zelfstandig naamwoord of bijvoeglijk naamwoord; log in (twee woorden) is het werkwoord.
- Zelfstandig/bijvoeglijk naamwoord: "het loginscherm," "de loginknop," "uw logingegevens," "een mislukte login" — overal waar het een ding benoemt of een ander zelfstandig naamwoord beschrijft, is het één woord.
- Werkwoord: "log alstublieft in," "log in met uw e-mailadres," "u moet eerst inloggen" — overal waar het de handeling van inloggen beschrijft, zijn het twee woorden.
Voorbeeld: "Ga naar het loginscherm, log dan in, klik vervolgens op de loginknop."
Hetzelfde patroon geldt voor logout/uitloggen: "de uitlogknop" (zelfstandig/bijvoeglijk naamwoord, één woord) versus "log uit wanneer u klaar bent" (werkwoord, twee woorden).
Bekijk de Website
Gebruik "bekijk de website" om een gebruiker die in de backend werkt te vragen de frontend te openen en de resultaten te controleren van de wijzigingen die ze zojuist hebben aangebracht.
Deze actie gebruikt de link Bekijk website in de backend-header, die de frontend opent in een nieuw browsertabblad. Dit creëert een workflow met twee tabbladen: de backend in het ene tabblad, de frontend in het andere, waarbij de gebruiker tussen beide wisselt om resultaten te controleren. Introduceer dit patroon vroeg — in de inleiding van de tutorial — zodat gebruikers er gedurende de daaropvolgende tutorials aan wennen om tussen tabbladen te wisselen.
Voorbeeld: "Klik in de backend-header op Bekijk website om de frontend in een nieuw tabblad te openen. Houd beide tabbladen open en wissel ertussen terwijl u deze tutorial doorloopt."
Beheerdersmenu
Het navigatiemenu aan de linkerkant in het beheergedeelte van de website wordt het Beheerdersmenu genoemd.
Frontend / Backend
Gebruik "frontend" om te verwijzen naar de publiek toegankelijke website, en "backend" om te verwijzen naar het beheergedeelte. Dit komt overeen met wat Joomla's eigen documentatie respectievelijk "de Website" en "de Beheerder" noemt.
Geef de voorkeur aan frontend/backend in tutorial-instructies, vooral wanneer een lezer wordt gevraagd in te loggen op de ene of de andere — dit leest natuurlijker als contrasterend paar. Gebruik Website/Beheerder alleen wanneer wordt verwezen naar Joomla's eigen officiële instellingen of menulabels, waar deze exacte termen voorkomen (bijvoorbeeld Website modules versus Beheerder modules).
Sleephendel
Gebruik "sleephendel" voor het pictogram (drie verticale puntjes) dat verschijnt in backend-lijstweergaven voor het herordenen van items — artikelen, menu-items, modules, categorieën en vergelijkbare lijsten ondersteunen dit allemaal. Het verschijnt na het klikken op het pijl-omhoog/omlaag-pictogram in de betreffende kolomkop, en alleen wanneer de lijst zodanig gefilterd of gesorteerd is dat ordenen mogelijk is.
Joomla's eigen codebase noemt dit intern de "sortable handler" (CSS-class sortable-handler, icoon icon-menu), maar "sleephendel" is de term die wordt gebruikt in Joomla-communitydocumentatie en forums, en is de meer herkenbare term voor lezers.
Voorbeeld: "Klik op de sleephendel naast Sidebar Announcement en sleep deze naar de bovenkant van de lijst."