Tanulás és szövegellenőrzés
Mikor magyarázd meg a szakszót? Az olvasó feladata döntsön
A szakszó akkor segít, ha az olvasó érti, és ugyanazt a fogalmat társítja hozzá. Vegyes közönségnek szánt szövegben a szokatlan kifejezést az első szükséges előfordulásnál röviden megmagyarázhatod, majd következetesen használhatod.
A cikk tartalma
A szó ismerete nem mindig a fogalom ismerete
A „verzió” sok olvasónak ismerős, de ettől még nem biztos, hogy tudja, melyik változatot kell letöltenie. A „stabil verzió” mellé például azt kell tisztázni, az adott oldalon mit neveztek stabilnak. Ne találj ki általános garanciát: a címke jelentését a projekt tényleges használata alapján magyarázd meg.
A magyarázat oda kerüljön, ahol szükség van rá
Ha a kifejezés nélkül nem érthető a következő lépés, ne csak a cikk végén adj meghatározást. Például: „Nyisd meg az archívumot, vagyis a korábbi anyagok gyűjteményét.” Később már használható az archívum szó. Hosszabb oldalon egy visszakereshető fogalomtár is segíthet, de az olvasónak észre kell vennie, hol érhető el.
A pontos szót ne cseréld folyton díszítő szinonimára
Ha egy felületen a fogalom neve előnézet, a következő bekezdésben ne nevezd bemutatónak, mintának és betekintőnek felváltva. Az olvasó külön funkciókat sejthet mögöttük. A közérthetőséghez rövid magyarázat és következetes megnevezés kell. Ez nem teljes akadálymentességi ellenőrzés, hanem a szöveg érthetőségét javító konkrét lépés.