Saya saat ini magang di kontraktor pemerintah dan saya merasa (secara tidak terhindarkan) merasa bahwa Word adalah standar de-facto dalam proses pengembangan perangkat lunak.
Format binernya membuatnya sangat sulit untuk berkolaborasi pada dokumen dengan cara saya terbiasa berkolaborasi pada basis kode. Penggunaan markup teks biasa (dengan bahasa seperti LaTeX, Markdown, Teks ReStructured, dll. ) Memungkinkan untuk dokumen yang ramah terhadap lingkungan yang bekerja dengan baik dengan alur kerja normal pengembang. Adapun komentar di mana bahasa tidak mendukung mereka (mis. Penurunan harga), ada banyak solusi yang ada yang memungkinkan komentar kolaboratif pada basis kode (misalnya GitHub, Bitbucket) yang dapat dengan mudah diterapkan ke file teks biasa lainnya yang berisi markup.
Saya mengerti perlunya bekerja sama dengan manajemen yang buta huruf secara teknologi mengharuskan semacam antarmuka grafis untuk semuanya, tetapi antarmuka seperti itu ada untuk sebagian besar format ini. Sebagai contoh, LaTeX memiliki 'fork' macam yang disebut LyX yang menempatkan front-end grafis ke teks biasa, seperti sintaksis seperti LaTeX. File ini, meskipun terutama grafis dalam pengeditannya, masih berbeda . (Bahkan ada komentar gaya Word.) Banyak dari solusi ini yang dapat digunakan sebagai pengganti Word, dan sebagian besar bebas atau open-source.
Namun, kami menggunakan Word bahkan untuk dokumentasi internal kami sendiri yang tidak dilihat orang lain. Kami bekerja dengan teks untuk sebagian besar karir kami --- mengapa dokumentasi begitu istimewa? Selain dari hal sepele, "Kami tidak tahu yang lebih baik dan sekarang kami terjebak di sini", pasti ada alasan yang mendukung keputusan semacam itu. Apa tantangan yang dihadapi proses pengembangan perangkat lunak dalam menggunakan dokumentasi teks-sederhana sebagai pengganti cara lain, lebih sederhana (dan kurang kuat) menulis dokumen?
Karena alasannya akan berbeda, mungkin menjawab untuk dua skenario yang berhubungan erat ini secara terpisah harus dalam urutan.
- Menggunakan dokumentasi teks biasa sejak awal
- Bermigrasi ke dokumentasi teks biasa dari waktu ke waktu
sumber
Jawaban:
Banyak peserta dalam proses pengembangan perangkat lunak bukan pengembang, dan memerlukan kemampuan untuk berinteraksi dengan dokumentasi. Haruskah QA / Pemasaran menggunakan kata dan pengembang menggunakan sesuatu yang lain sepenuhnya? Itu akan menjadi tidak konsisten, itu akan menambah alat lain ke dalam rantai pemeliharaan dan bagian IT perusahaan mungkin tidak tahu apa yang harus dilakukan dengan file, ketika mereka tahu benar bagaimana mengelola / memelihara penyimpanan dokumen kata.
Di atas segalanya, banyak non-pengembang telah menghabiskan waktu bertahun-tahun di universitas menggunakan Microsoft Word untuk menyerahkan pekerjaan mereka, sering kali memiliki kelas pelatihan aktual hanya dalam cara menggunakan kata. Mereka tahu itu jauh lebih baik daripada alternatif. Saya hampir tidak dapat membedakannya ketika saya bekerja di Open Office vs Word, tetapi ketika saya memiliki saudara ipar saya menggunakannya untuk menghemat uang, seminggu kemudian dia meminta suaminya untuk membeli Word dan menyatakan "Sejak saya mendapat kata, saya suka laptop baru saya! " Pikirkan tentang pola pikir yang mengonfigurasikan hal-hal seperti itu, sedikit perubahan pada apa yang mereka gunakan bukanlah 'sedikit' bagi mereka.
Kata modern memungkinkan perbedaan versi, anotasi dengan pelacakan versi dan penggabungan perubahan juga. Mungkin tidak semudah penggabungan kode, tetapi saya telah melihat banyak manajer proyek melakukannya dengan mudah, jadi tentunya devs dapat mengatur untuk melakukannya juga.
Selain itu, sudah menjadi hal yang umum di antara tim dev untuk melakukan dokumentasi dalam wiki karena ia kembali ke representasi tekstual sambil tetap cukup sederhana sehingga non-pengembang dapat mengedit.
sumber
Secara pribadi saya pikir ini masalah pendidikan.
Kebanyakan orang telah tertipu untuk berpikir bahwa menggunakan alat seperti MS Word membuatnya lebih mudah untuk menghasilkan dokumen yang berkualitas, tetapi dari apa yang saya lihat itu sebenarnya membuatnya lebih sulit. Anda akhirnya harus men-debug format tanpa henti dan melawan alat Anda untuk mendapatkan hasil yang Anda inginkan.
Alat-alat seperti Scrivener memungkinkan Anda untuk sedikit lebih dekat dengan realitas dokumen tanpa harus berjuang seperti yang Anda lakukan dengan Word. Sebagian karena realisasi, WYSIWYG tidak benar-benar berfungsi dengan baik.
Di organisasi saya sendiri, semakin banyak orang yang saya gunakan untuk menggunakan MarkDown untuk sebagian besar dokumen mereka, semakin banyak orang lebih bahagia dan lebih produktif.
sumber
expl3pesan kesalahan jauh lebih membantu :)Anda benar-benar memiliki 2 pertanyaan:
Pertama: Mengapa kelompok non pengembangan tidak menggunakan LaTeX atau penurunan harga lainnya dalam proses pengembangan perangkat lunak?
Masalah dengan migrasi ke LaTeX adalah kurva pembelajaran yang dirasakan terutama ketika Anda berurusan dengan pengguna non teknis. Pengguna sudah tahu format lain dan tidak mau harus belajar metode lain untuk melakukan hal yang sama yang mereka lakukan. Mereka tahu sedikit jika ada cara untuk membedakan 2 dokumen sehingga ada sedikit nilai dalam mengubah ke format berbasis teks untuk mereka. Menjelaskan kepada seseorang bahwa Anda memiliki solusi untuk masalah yang mereka tidak tahu mereka miliki adalah penjualan yang cukup sulit.
Anda juga tidak bisa meremehkan nilai momentum ke depan. Untuk bermigrasi ke format baru, Anda benar-benar harus meyakinkan orang lain dalam rantai Anda, ada baiknya investasi untuk mempelajari sesuatu yang baru. Bahkan jika Anda tidak mengharapkan mereka untuk mengedit apa pun. Butuh waktu dan banyak upaya untuk bermigrasi ke format baru ketika format yang ada berfungsi (bahkan jika buruk).
Pertanyaan kedua: Mengapa tim saya terus menggunakan dokumen kata ketika ada opsi yang lebih baik dan mereka lebih dari mampu mempelajarinya?
Ini adalah sesuatu yang harus Anda bicarakan dengan orang-orang di tim Anda. Mungkin ada alasan yang sah bahwa mereka memilih untuk memelihara dokumen kata atau mungkin hanya karena itulah yang selalu dilakukan.
Ada biaya yang terkait dengan perubahan apa pun dan itu bisa mahal dan memakan waktu untuk memindahkan ratusan atau ribuan dokumen ke format baru. Jika Anda akan mencoba mengubah lingkungan Anda, Anda harus membuat alasan mengapa Anda harus berubah
sumber