Úpravy manuálu

Manuál môžete meniť úpravou miestnych textových súborov. Tieto súbory sa synchronizujú s tými priamo pripojenými prostredníctvom úložiska, na základe toho bude server priamym pripojením aktualizovať manuál.

Manuál je napísaný v značkovom jazyku reStructuredText (RST) a je možné ho upravovať použitím textového editora. Pre miestny náhľad konvertujete (zostavíte) zdrojové súbory príručky z RST na webové stránky HTML.

Aktualizácia

Firstly, make sure that your local copy of the manual is up to date with the online repository using:

svn update

Písanie

Teraz môžete upravovať súbory dokumentácie, ktoré sú súbormi .rst v priečinku manual, použitím textového editora podľa svojho výberu.

Be sure to check the Sprievodca štýlom písania for conventions and Sprievodca štýlom značiek to learn how to write in the reStructuredText markup language.

Veľa šťastia pri písaní!

Väčšie zmeny

If you are going to add or overhaul a section, be sure to check carefully that it does not already exist. In some places, the docs are so disorganized that sections may be duplicated or in a strange location. In the case that you find a duplicate or out of place section, create a task explaining the issue, and optionally include a revision (actual changes).

Pred vykonaním akýchkoľvek úprav, ktoré nie sú jednoduché a zreteľne odôvodnené (napríklad presunutie priečinkov), by ste si mali pomocou správcu príručky overiť, že váš príspevok zodpovedá predstavám komunity o príručke. Takto je zaistené čo najlepšie využitie vášho času a ochoty, pretože je možné, že z nejakého dôvodu budú vaše zmeny v konflikte a budú odmietnuté alebo si vyžadujú časovo náročnú kontrolu. Napríklad iná osoba už môže pracovať na sekcii, ktorú chcete zmeniť, môže byť naplánované odstránenie sekcie alebo aktualizácia podľa plánovanej zmeny Blenderu.

Včasná a častá komunikácia je kľúčom k vytvoreniu produktívneho prostredia, predídeniu plytvania úsilím ľudí a dosiahnutiu lepšieho manuálu Blendera.

Získanie pomoci/odpovedí

Ak máte pochybnosti o funkčnosti, ktorú chcete zdokumentovať, mali by ste svoje otázky položiť vývojárom Blenderu zodpovedným za túto oblasť alebo sa opýtať na neoficiálnom kanáli podpory užívateľov v #docs alebo #blender-coders kanáli v Blender Chat.

Samotný Blender má systém vlastníkov modulov s vývojárskymi a umeleckými členmi, ktorí sú zodpovední za dizajn a údržbu pridelených oblastí Blenderu. Ďalšie informácie nájdete na stránke Vlastníci modulov.

Náhľad

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.

Načítanie

Ak ste so svojimi zmenami spokojní, môžete si ich načítať, aby boli v priamo pripojenom manuáli. Spočiatku sa to robí odoslaním opravných záplat, aby niekto mohol skontrolovať vaše zmeny a poskytnúť vám spätnú väzbu. Neskôr môžete zmeny potvrdzovať priamo. Tento proces je podrobne popísaný v nasledujúcej časti.