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.
Ako se ukaže potreba naravno da ćemo dodavati i druge tipove dokumenata. Predlažite.

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.

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 sažetku 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 neki ili svi čitaoci kojima je namenjen nemaju neophodna predznanja za potpuno razumevanje članka.

Ako se radi o nekim opštim stvarima čitalac može na internetu da sazna i šta je tar i kako se koristi, ali mu štedimo vreme dodajući kratka pojašnjenja.

Ako se radi npr. o Balansu, na internetu se ne može naći ni šta je "Bort", ni šta je "Edi". Ako u članku nemamo objašnjenje čitalac će nekome od vas oduzeti vreme - neko mora da mu objasni informaciju koju ne može sam da pronađe.

Kada je detaljni članak duži od 15-20 (ili još više) minuta čitanja možda bi bilo smisleno podeliti ga na nekoliko kraćih članaka koje bi ste povezali kontrolom (komponentom) {{prev-next}}. Opisana je ovde, a možete je pogledati na dnu ove strane.

Kreiranje novog članka na MelanyWiki

Uputstvo za kreiranje članka