Ohjeet: Keskustelun ohjeet

• Otsikon valinta
• Viestin kirjoittaminen
• Kooditagit
• Muut muotoilukeinot

Ohjelmointiputkan keskustelualue on tarkoitettu pääasiassa ohjelmointiaiheisille viesteille, mutta muistakin aiheista voi keskustella yleisessä keskustelussa. Keskusteluun ovat tervetulleita kaikki ohjelmoinnista kiinnostuneet iästä, taustasta ja ohjelmointitaidosta riippumatta. Muiden keskustelijoiden kunnioittaminen, kannustaminen ja opastaminen luovat hyvän keskusteluilmapiirin.

Ennen uuden keskustelun avaamista on hyvä tarkistaa, onko Ohjelmointiputkassa aikaisemmin keskusteltu samasta asiasta. Sivun oikeassa ylänurkassa olevalla hakukoneella voit etsiä yhtä aikaa vanhoista keskusteluista, koodivinkeistä ja oppaista. Kannattaa myös kokeilla Google-hakua.

Otsikon valinta

Kun aloitat keskustelun, valitse sille kunnollinen otsikko, josta ilmenee heti keskustelun aihe. Näin viestisi ei huku muiden samanlaisten sekaan. Esimerkiksi "Ongelma" on huono otsikko, sillä ongelmia voi olla niin monenlaisia. Tarkempi otsikko "Pokerivastustajan tekoäly" kertoo jo paljon enemmän. Älä vaihda asiaa kesken keskustelun; jos haluat keskustella jostain muusta, aloita uusi keskustelu uudella otsikolla.

Viestin kirjoittaminen

Kiinnitä huomiota viestin kieliasuun. Kirjoita viesti niin selvästi, että sen ymmärtää heti ensi lukemalla. Lukemista helpottavat isot alkukirjaimet, välimerkit, kappalejako ja kooditagit. Kun esität kysymyksen, kuvaile ongelma huolellisesti ja tarpeeksi kattavasti. Muista myös mainita kaikki tarvittavat yksityiskohdat kuten käyttämäsi ohjelmointikieli. Liitä myös mukaan mahdolliset virheilmoitukset sekä pätkä toimimattomasta koodista.

Voit lainata muiden käyttäjien tekstiä lainaustagien avulla. Pyri lainaamaan vain olennaiset osat; tekstin turha kopioiminen vaikeuttaa keskustelun lukemista jälkikäteen.

Kooditagit

Kun liität viestiin koodia, kirjoita sen ympärille kooditagit. Silloin kaikki merkit ovat yhtä leveitä ja sisennykset eivät katoa. Joillekin ohjelmointikielille on omat väritetyt kooditagit. Uusia värityksiä tulee toisinaan eikä kaikkia näistä ole lueteltu alla, joten tunnettujen kielten nimiä voi itsekin kokeilla viesteissä.

[koodi]Morjens![/koodi]

Morjens!

[koodic]
#include <stdio.h>
int main(void) {
    printf("Morjens!");
}
[/koodi]

#include <stdio.h>
int main(void) {
    printf("Morjens!");
}

[koodiphp]
if (true) {
  echo "Morjens!";
}
[/koodi]

if (true) {
  echo "Morjens!";
}

[koodiqb]PRINT "Morjens!"[/koodi]

PRINT "Morjens!"

[koodisql]
SELECT * FROM taulu WHERE luku = 123
[/koodi]

SELECT * FROM taulu WHERE luku = 123

Muun muassa seuraavat väritykset ovat jo olemassa:

Muitakin kielten nimiä tai lyhenteitä voi käyttää; uusia värityksiä lisätään tarpeen mukaan. Jos kieli on tuntematon, koodi jää värittömäksi kuten ensimmäisessä esimerkissä.

Muut muotoilukeinot

Voit käyttää viesteissä seuraavia muotoilumerkintöjä:

auki: [h], kiinni: [/h]

http://www.ohjelmointiputka.net/

[linkki "http://www.php.net/"]PHP[/linkki]

[lainaus "Antti Laaksonen"]Mitä mieltä olette?[/lainaus]

[t]teksti[/t]

[l]käytä[/l]

[k]säästeliäästi[/k]

2[yl]3[/yl] = 8

H[al]2[/al]O

[lip]
[lik]apina
[lik]banaani
[/lip]