Amikor dokumentumot ír, és egy szoftvermintára szeretne hivatkozni, ügyeljen arra, hogy elegendő információt adjon olvasóinak ahhoz, hogy maguk is megtalálják ugyanazt a mintát. A szoftverminták könyvekben, folyóiratokban és konferencia-kiadványokban jelennek meg, és ugyanúgy hivatkozni kell rájuk, mint bármi másra. Íme néhány irányelv:
-
Állítsd be a nevet. A dokumentum törzsében állítsa be, hogy a minta neve eltérjen a normál szövegtől. Általában a minták készítői ezt kis nagybetűs karakterformázással, a minta címének aláhúzásával vagy következetesen nagybetűkkel teszik.
-
Jelölje meg a mintát. Jelölje be a mintát, hogy az olvasók megtalálhassák a teljes mintát egy részletes hivatkozáson keresztül. Használjon bármilyen hivatkozási módszert a dokumentum többi részében – lábjegyzetekben, végjegyzetekben vagy soron belül (a szöveggel zárójelben).
-
Adja meg az összes forrást. Minden mintahivatkozáshoz adja meg az összes tipikus referenciaanyagot, például a szerzőt, a minta nevét és a minta megtalálásának helyét (például könyvet vagy webhelyet). Néha elég ember ismeri a hivatkozást ahhoz, hogy gyorsírást tudjon használni.
-
Dátum a verzió. Mindig adja meg a használt mintaverzió dátumát, különösen, ha a forrás módosulhat vagy frissülhet. A weboldalak mintái például könnyen frissíthetők. Mivel a minták írása véget nem érő folyamat, a mintákat folyamatosan finomítják, és a minták szerzői minden új verzióhoz új dátumot írnak fel.