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

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)

Ei varmaan kukaan kerrallajaksa rueta muuttamaan, mutta senkin voi laittaa tuonne tekemistä-listalle niin joku (todennäköisesti minä) tekee sen hiljalleen tylsinä hetkinä :). --Maakuth 18. elokuuta 2007 kello 19.37 (EEST)

Laitoin tämän nyt suositukseksi merkitsemiskäytäntöihin. --Heikki 27. elokuuta 2007 kello 11.06 (EEST)

Kursivoinnit ja tt-tagit

Laitoin merkitsemiskäytäntöihin nyt maininnan siitä, että tekstin seassa olevat koodit laitetaan <tt>- ja </tt> -tagien väliin kuten tähän asti on tehty. Sen sijaan epäselvyyttä on siitä, käytetäänkö esimerkiksi käyttöliittymän valikkoteksteissä ja ohjelmapakettien nimissä <tt>:tä vai kursivointia (''tekstiä''). Ehdotuksia? --Heikki 27. elokuuta 2007 kello 11.06 (EEST)

Minusta tuo kursivointi olisi noille käyttöliittymäteksteille ainakin selkeämpi ratkaisu. <tt> -muotoiltu teksti antaa minusta ymmärtää, että tekstin tulee olla merkilleen oikein, tai homma ei toimi. Suomennoksissa on kuitenkin eroja, ja eri kieliäkin on käytössä. Yleensä ainakin tasalevyisiä kirjaimia käytetään komentorivien lisäksi esim. asetustiedostoja muokattaessa ja näytettäessä. Graafisessa käyttöliittymässä kuitenkin aika harvalla on tasalevyinen fontti valittuna. Tasalevyistä en siis itse kannata niihin. Valikkoteksti kannattaa minusta kuitenkin erottaa muusta ohjetekstistä, joten kursivointi olisi siihen yksi vaihtoehto. --Muep 27. elokuuta 2007 kello 14.14 (EEST)

Jos valikkoteksteihin jonkinlaista muotoilua laitetaan, niin kursivointi on kyllä selvästi parempi vaihtoehto. Pakettien nimissä kannattaisin ehkä mieluummin tt:tä, mutta tämä kyllä riippuu ennen kaikkea siitä, mikä sopii sivun yleiseen tyyliin. --Pb 27. elokuuta 2007 kello 20.20 (EEST)