Tipovi dokumenata u MelanyWiki

2 min

Opis tri osnovna (za sada) tipa dokumenata na MelanyWiki. Koja je razlika između njih?

Trenutno (novembar 2025.) imamo 3 tipa dokumenta na MelanyWiki. Kontrolnu listu (check list), običan članak i detaljni članak. Ovi nazivi su uslovni, predložite bolje, jasnije nazive.
Smisao ove podele je da, ukoliko dobijete zadatak da nešto napišete, odmah znate koliko je detaljno neophodno pisati. Koliko opširno.

Donja tri primera govore o istom, ali se razlikuju po detaljnosti:
- raspakujte archive.tar.gz;
- raspakujte arhivu komandom tar -xzvf archive.tar.gz;
- tar je Linux/Unix (de)arhivator. Raspakujte arhivu komandom tar -xzvf archive.tar.gz. Značenje parametara je:
-x extract - raspakuj
-z gzip - dekompresuj programom gzip
-v verbose - piši u terminalu šta radiš
-f file - fajl koji treba raspakovati. Ovo (-f) se obavezno dodaje na kraju, pre naziva fajla. Redosled prethodnih parametara nije bitan.

Ako se ukaže potreba naravno da ćemo dodavati i druge tipove dokumenata. Predlažite.

Kontrolna lista / check list

Najkraći dokument. Ničeg suvišnog. Podsetnik. Numerisani spisak postupaka. Primer:

1. Konektovati se na PG server komandom
   ssh moj_nalog@10.0.0.23
2. Napraviti dump komandom
   pg_dump -U moj_nalog -d imebaze -f imebaze_backup.sql
3. Diskonektovati se sa PG servera (exit)
4. Na svojoj mašini povući dump sa DB servera komandom
   scp moj_nalog@10.0.0.23:/home/moj_nalog/imebaze_backup.sql ./

U abstract-u opišite na šta se kontrolna lista odnosi. Primer:

<1 min

Kontrolna lista za pravljenje kopije PostgreSQL baze podataka na 10.0.0.23

Običan članak

Običan članak je dokument koji se može pročitati za 1 do 5 minuta. Preporuka je da bude do 5 minuta ali nije strašno ni ako je 6 ili 7. Verovatno će većina dokumenata u MelanyWiki biti ovog tipa. Primer običnog članka je npr. https://rd.melany.rs/doku.php?id=kb:instalacija_balansa_pod_ubuntu-kubuntu

Ne ulazi se preduboko u objašnjavanje, podrazumeva se da čitalac poseduje neophodna predznanja.

Detaljni članak

Detaljni članak je, očigledno, detaljniji. Pretpostavljamo da čitaoci kojima je namenjen nemaju neophodna predznanja za potpuno razumevanje članka.

Ako u Pregledu imamo navedenu komandu tar -xzvf archive.tar.gz u Članku ćemo je objasniti tako da je razume neko ko nikada nije radio sa Linuksom. Nećemo samo navesti komandu, već i detaljno opisati.
tar - Unix/Linux komanda za pakovanje više fajlova/direktorijuma u jedan fajl. Tar ne vrši kompresiju, on za to koristi eksterne programe.
-x extract - raspakuj
-z gzip - dekompresuj programom gzip
-v verbose - piši u terminalu šta radiš
-f file - fajl koji treba raspakovati. Ovo se dodaje na kraju, pre naziva fajla.

Obratite pažnju

Svi navedeni nazivi su uslovni.
Imamo dokumente koje možemo pročitati za par minuta, i druge koje treba čitati 10-20 minuta, ili više. Imamo i kontrolnu listu koju ne čitamo već izvršavamo korak po korak.

Kreiranje novog članka na MelanyWiki

Uputstvo za kreiranje članka