Urejanje priročnika
Priročnik lahko spreminjate tako, da urejate lokalne besedilne datoteke. Te datoteke so usklajene s tistimi na spletu prek repozitorija. Na podlagi tega bo strežnik posodobil spletni priročnik.
The manual is written in the reStructuredText (RST) markup language and can be edited using a plain text editor. For a local preview, you convert (build) the manual source files from RST into HTML web pages.
Posodabljanje
Firstly, make sure that your local copy of the manual is up to date with the online repository using:
svn update
Pisanje
Zdaj lahko z vašim najljubšim urejevalnikom besedila spreminjate dokumentacijske datoteke, torej datoteke .rst v mapi manual.
Be sure to check the Vodič za pisanje for conventions and Oblikovni vodič to learn how to write in the reStructuredText markup language.
Srečno s pisanjem!
Večje spremembe
Če boste dodali ali popravili razdelek, se prej prepričajte, da še ne obstaja. Ponekod je dokumentacija v tolikšnem neredu, da so morda kakšni razdelki podvojeni ali na čudnih lokacijah. V primeru, da odkrijete podvojen ali napačno odložen razdelek, ustvarite nalogo (seveda v angleščini), v kateri razložite težavo in, če želite, priložite revizijo (dejanske spremembe).
Preden naredite kakršnekoli spremembe, ki niso preproste in jasne (na primer premikanje map), se z vzdrževalcem priročnika posvetujte, ali je vaš prispevek v skladu z vizijo skupnosti. S tem boste najbolje izkoristili čas in dobro voljo, saj se drugače utegne zgoditi, da bodo vaše spremembe iz kakršnega koli razloga navzkriž z drugimi in bodo zavrnjene ali deležne dolgotrajnega pregleda. Na primer, neka druga oseba morda že dela na razdelku, ki ga želite spremeniti, ali pa razdelek morda čaka na izbris ali posodobitev z ozirom na prihajajoče spremembe v Blenderju.
Pravočasna in pogosta :ref:`komunikacija <contribute-contact>`je ključna za produktivno okolje, v katerem se delo članov ne zapravlja in katerega končni rezultat je kakovosten priročnik za Blender.
Dobivanje pomoči ali odgovorov
If you are in doubt about functionality that you wish to document,
you should pose your questions to the Blender developers responsible for that area or ask at the unofficial user
support channel in the #docs or #blender-coders channel in Blender Chat.
Blender ima sistem lastnikov modulov z razvijalci in umetniki, ki so odgovorni za dizajn in vzdrževanje določenih področij. Za več informacij si preberite stran lastnikov modulov (v angleščini).
Predogled
To view your changes, build the manual as instructed.
Keep in mind that you can also build only the chapter you just edited to view it quickly.
Open the generated .html files inside the build/html folder using your web browser,
or refresh the page if you have it open already.
Nalaganje
Ko ste s svojimi spremembami zadovoljni, jih lahko objavite, da bodo vidne na spletnem priročniku. Sprva to počnete tako, da oddate popravke (ang. patches). Tako bo lahko nekdo pregledal vaše spremembe in vam dal povratno informacijo. Kasneje lahko svoje spremembe oddate kar neposredno. Ta proces je podrobno opisan v naslednjem razdelku.