Tambalan & Komit

Mengirimkan Tambalan

Untuk beberapa perubahan pertama yang Anda lakukan ke manual, Anda akan perlu untuk mengirimkan perubahan tersebut sebagai tambalan supaya dapat ditinjau oleh seorang administrator. Hal ini hanya supaya kita menjaga kualitas manual pengguna, dan agar Anda secara tidak sengaja merusak sesuatu yang penting sebelum Anda terbiasa dengan sistem ini.

Untuk mengirimkan tambalan, ikuti proses ini:

Membuat segala perubahan yang Anda inginkan.
Membuat file tambalan dengan cara mejalankan:
```
svn diff > filename.diff
```
Hal ini membuat file teks sederhana yang memaparkan teks apa yang ditambah, dihapus atau diubah di antara file-file pekerjaan Anda dan repositori pusat.

Jika Anda telah membuat atau menghapus file, Anda perlu menjalankan svn add /path/to/file atau svn rm /path/to/file sebelum membuat diff. Untuk melihat daftar file yang berubah, jalankan svn status.
Unggah file diff disini. Jika Anda belum mempunyai akun, Anda dapat mendaftarkan diri.
After submitting the diff, you will be asked to "Create a new Revision" before you can add a title and description of your changes.
Tolong periksa jika project Dokumentasi ditugaskan dalam bidang tag untuk memberi tahu tim tambalan Anda. Anda juga dapat kontak tim melalui daftar mail atau Blender Chat.
Mereka akan meninjau tambalan Anda dan memberi tahu Anda tentang perubahan yang dapat Anda lakukan. Jika tidak ada masalah, tambalan Anda akan diterima dan kemudian dikomit oleh tim tambalan Anda.

Catatan

Jika tambalan Anda termasuk perubahan atau tambahan gambar, hanya perlu dilampirkan saat Anda sedang membuat revisi.

Tambalan langsung akan pasti diterima dengan cepat. Setelah Anda terbiasa membuat perubahan dan tidak perlu lagi masukan, kami akan memotong orang tengah dan memberikan Anda akses langsung untuk mengedit manual.

Lihat juga

See Siklus Rilis for documentation on how to make commits to a specific release branch and how to create merge commits.

Melakukan Komit Langsung

Setelah Anda dberi akses langsung untuk mengedit manual, Anda dapat mulai melakukan komit langsung daripada membuat file tambalan. Melakukan ini akan mengirimkan perubahan lansgung ke repositori pusat.

Sekarang yang perlu Anda lakukan adalah hanya menjalankan:

svn commit -m "This is what I did"

Jika anda meninggalkan -m "message", Anda akan diminta untuk mengetik sebuah pesan di editor teks.

Jangan lupa untuk selalu menjalankan svn update sebelum melakukan komit.

Then you will be asked for your username and password (from developer.blender.org) before the change is committed.

Catatan

Make sure to use your username (case sensitive) and not your email.

File yang dimodifikasi diunggah ke repositori pusat untuk dikerjakan orang lain dan terus berkolaborasi. Komit dilacak di repositori 'Diffusion <https://developer.blender.org/diffusion/BM/>'__. Segera setelah perubahan Anda terlihat di manual online.

Writing a Good Commit Message

When making changes to the manual that directly relate to a specific commit (change) in Blender, it is helpful to make the title of the commit the same as the commit made to Blender. It is requested that you include the commit hash of the commit made to the Blender source code.

For example, the commit rBM8473 includes a descriptive indicative of the changes made along with the hash rBa71d2b260170. The hash can be extracted from the URL provided in the Documentation task for a specific upcoming release.

Other more general changes do not have to follow the above policy however, it is still important to make the description clear about what changes you made and why. It can be helpful to prefix the commit title with a prefix word such as Cleanup: or Fix: when you are making general cleanups or fixes respectively.

Writing good commit messages helps administrators keep track of changes made and ensures all new features are properly documented.