Ero sivun ”Keskustelu Linux.fista:Merkitsemiskäytäntöjä” versioiden välillä
Siirry navigaatioon
Siirry hakuun
Keskustelu Linux.fista:Merkitsemiskäytäntöjä (muokkaa)
Versio 18. elokuuta 2007 kello 19.18
, 18. elokuuta 2007ei muokkausyhteenvetoa
(→Lisää määrittelyä: määrittely ennen selitystä) |
Pb (keskustelu | muokkaukset) Ei muokkausyhteenvetoa |
||
| Rivi 2: | Rivi 2: | ||
Olisi varmaan tarpeen määritellä [[Linux.fi:Merkitsemiskäytäntöjä|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. --[[Käyttäjä:Maakuth|Maakuth]] 18. elokuuta 2007 kello 18.48 (EEST) | Olisi varmaan tarpeen määritellä [[Linux.fi:Merkitsemiskäytäntöjä|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. --[[Käyttäjä:Maakuth|Maakuth]] 18. elokuuta 2007 kello 18.48 (EEST) | ||
:Minusta selitys ennen komentoa on selkeämpää. --[[Käyttäjä:Heikki|Heikki]] 18. elokuuta 2007 kello 18.52 (EEST) | :Minusta selitys ennen komentoa on selkeämpää. --[[Käyttäjä:Heikki|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? --[[Käyttäjä:Pb|Pb]] 18. elokuuta 2007 kello 19.18 (EEST) | |||