Keskustelu Linux.fista:Merkitsemiskäytäntöjä

Linux.fista
Versio hetkellä 18. elokuuta 2007 kello 19.18 – tehnyt Pb (keskustelu | muokkaukset)
Siirry navigaatioon Siirry hakuun

Lisää määrittelyä

Olisi varmaan tarpeen määritellä merkitsemiskäytäntöjä vähän enemmän. Eräs asia johon tarvittaisiin selkeä linja on koodiesimerkkien kommentointi, niistä kun on kahta koulukuntaa. Jotkut laittavat ensin selityksen, ja sitten esimerkin (ks. vaikkapa Wine), toiset taas päinvastoin (esim. Cat. Kumpaa kannatatte? Näistä ja muista asioista tarvittaisiin selkeä linja niin wikin luettavuus varmaankin paranisi huomattavasti. --Maakuth 18. elokuuta 2007 kello 18.48 (EEST)

Minusta selitys ennen komentoa on selkeämpää. --Heikki 18. elokuuta 2007 kello 18.52 (EEST)
Selitys ennen komentoa on kyllä yleisesti ottaen selkeämpi vaihtoehto, mutta mielestäni myös päinvastaista käytäntöä pitäisi voida käyttää mikäli se tuntuu perustellulta. Lähes kaikkiin artikkeleihin olen tähän mennessä laittanut sen esimerkin ennen selitystä. Uusissa artikkeleissa voisi ehkä ryhtyä käyttämään pääasiassa tätä toista tapaa. Vanhoja artikkeleita (joita on muutama sata) jaksaa tuskin kukaan ryhtyä muuntamaan? --Pb 18. elokuuta 2007 kello 19.18 (EEST)