Mengedit Manual

Anda dapat memodifikasi manual dengan mengedit file teks lokal. File-file tersebut disimpan secara sinkron dengan yang online melalui repositori, berdasarkan ini, server ini akan mengupdate manual online.

Manual ini ditulis dalam bahasa markup reStructuredText (RST) dan dapat diedit menggunakan teks editor polos. Untuk pratinjau, Anda dapat mengubah source file manual (build) dari RST menjadi laman HTML.

Update

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

svn update

Menulis

Anda sekarang dapat mengedit file dokumentasi yang merupakan file .rst` dalam folder ``manual dengan menggunakan editor teks sesuai pilihan Anda.

Be sure to check the Panduan Gaya Menulis for conventions and Panduan Gaya Markup to learn how to write in the reStructuredText markup language.

Selamat menulis!

Perubahan yang Lebih Besar

Jika Anda akan menambahkan atau merombak suatu bagian, pastikan untuk memeriksa dengan cermat bahwa itu belum ada. Di beberapa tempat, dokumen sangat tidak teratur sehingga bagian mungkin diduplikasi atau di lokasi yang aneh. Jika ada kasus Anda menemukan bagian duplikat atau tidak pada tempatnya, buatlah tugas menjelaskan permasalahannya, dan secara optimal tambahan revisi (perubahan sebenarnya).

Sebelum Anda membuat edit yang tidak sederhana dan dapat dibenarkan secara polos (contohnya saat memindahkan folder), Anda seharusnya vertifikasi dengan penjaga manual bahwa kontribusi Anda sesuai dengan visi komunitas untuk manual. Hal ini memastikan penggunaan waktu dan niat baik Anda dengan sebaik-baiknya karena mungkin saja, karena alasan tertentu, perubahan Anda akan bertentangan dan ditolak atau perlu tinjauan yang memakan waktu. Misalnya, orang lain mungkin sudah mengerjakan bagian yang ingin Anda ubah, bagian tersebut mungkin dijadwalkan untuk dihapus atau diperbarui sesuai dengan perubahan yang direncanakan ke Blender.

Komunikasi lebih awal dan sering adalah kunci untuk memiliki lingkungan yang produktif, tidak menyia-nyiakan usaha orang dan mendapatkan manual Blender yang lebih baik sebagai hasilnya.

Mendapatkan Bantuan/Jawaban

Jika Anda ragu tentang fungsionalitas yang ingin Anda dokumentasikan, Anda seharusnya mengajukan pertanyaan Anda kepada developer Blender yang bertanggung jawab untuk area itu atau bertanya di saluran bantuan pengguna tidak resmi di #docs atau saluran #blender-coders di Blender Chat.

Blender sendiri memiliki sistem pemilik modul dengan anggota developer dan artis yang bertanggung jawab atas desain dan pemeliharaan area Blender yang ditetapkan. Lihat module owners page untuk informasi lebih lanjut.

Pratinjau/Melihat Kembali

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.

Upload

Jik Anda sudah senang dengan perubahan Anda, Anda dapat mengupload perubahan tersebut, supaya mereka dapat masuk ke dalam manual online. Pada awalnya, hal ini diselesaikan dengan mengirimkan tambalan supaya seseorang dapat meninjau kembali perubahan Anda dan memberikan masukan. Setelah itu, Anda dapat komit perubahan Anda langsung. Proses ini dideskripsikan lebih detail di bagian berikutnya.