Setiap kali saya menemukan API atau bahasa pemrograman baru atau bahkan halaman manual Linux yang sederhana , saya selalu (sejak saya ingat) menghindarinya dan sebaliknya dengan malas mengandalkan contoh untuk mendapatkan pemahaman konsep baru.
Secara tidak sadar, saya menghindari dokumentasi / API setiap kali tidak langsung atau samar atau hanya membosankan. Sudah bertahun-tahun sejak saya mulai pemrograman dan sekarang saya merasa perlu memperbaiki cara saya karena sekarang saya menyadari bahwa saya menyebabkan lebih banyak kerusakan dengan menahan diri dari membaca dokumentasi samar / sulit karena masih sejuta kali lebih baik daripada contoh sebagai pejabat dokumentasi memiliki cakupan lebih dari contoh apa pun di luar sana. Bahkan setelah menyadari bahwa contoh-contoh harus diperlakukan sebagai nilai "tambah" alih-alih sumber "primer" untuk belajar.
Bagaimana saya menghentikan kebiasaan buruk ini sebagai seorang programmer atau saya terlalu banyak berpikir?
sumber
a million times better than examples as the official documentation has more coverage- Tidak selalu, saya telah menemukan beberapa fitur besar tidak berdokumen di masa lalu melalui contohJawaban:
Kebiasaan mengandalkan preferensi pada contoh tidak ada yang salah: bagi Anda, itu hanya cara tercepat untuk mendapatkan jawaban Anda. Apalagi contohnya visual. Lebih mudah untuk mem-parsing secara visual contoh daripada membaca paragraf teks dan mengekstrak informasi yang Anda butuhkan.
Contoh:
terperinci, tetapi membosankan dan sulit dibaca. Fakta bahwa Anda perlu mengikuti tautan membuat segalanya semakin buruk. Jika kami menambahkan beberapa sampel, menjadi lebih mudah dipahami:
Fakta bahwa Anda hanya menggunakan contoh mungkin menjadi masalah. Jangan terus-menerus berhenti menggunakan contoh-contoh ini, tetapi ingatlah bahwa begitu Anda mendapatkan ide, dokumentasi yang lebih jelas dapat membantu. Misalnya, sampel di atas tidak menunjukkan bahwa daftar produk dibatasi hingga 1.000: Anda harus membaca dokumentasi untuk itu.
Kapan Anda tahu bahwa Anda harus membaca dokumentasinya?
Setiap kali API atau pustaka tidak berperilaku seperti yang Anda harapkan. Misalnya, Anda mengambil sampel dan melakukan:
Untuk beberapa alasan, ia mengembalikan kurang dari 3.000 item, sementara Anda memiliki lebih dari dua puluh ribu produk di database Anda. Di sini, API tidak berlaku seperti yang Anda harapkan, jadi ini saat yang tepat untuk membaca dokumentasi terperinci.
sumber
Informasi yang disediakan oleh dokumentasi termasuk dalam tiga kategori:
Resep atau contoh membuat jembatan antara domain masalah dan fungsi perangkat lunak. Referensi menjelaskan sepenuhnya beberapa fungsi dan berguna jika Anda ingin mengadaptasi resep ke kasus tertentu.
(Pengetahuan ahli memetakan konsep domain masalah ke konsep dokumentasi, akan berguna jika konsep dapat diungkapkan dalam beberapa cara atau jika pengguna perangkat lunak bukan ahli di lapangan.)
Saya tidak berpikir bahwa kebiasaan Anda buruk. Saat Anda mempelajari suatu API, Anda pertama-tama mendapatkan gagasan tentang masalah mana yang dapat diselesaikan dan metodologi mana yang disediakan dengan bantuan Resep (contoh Anda). Dokumentasi referensi kemudian membantu Anda menyempurnakan metodologi untuk kasus-kasus khusus.
sumber
Contohnya adalah dokumentasi. Saya tidak berpikir itu buruk dari menjadi terbiasa dengan sudut pandang API. Jika itu adalah satu-satunya dokumentasi yang Anda lihat maka itu bisa menjadi masalah. Sebagian besar contoh berhemat pada pemeriksaan kesalahan yang dapat menyebabkan kode terlalu rapuh jika Anda tidak kembali dan mengambil bagian yang hilang dari dokumentasi referensi.
sumber
Orang yang berbeda belajar lebih baik dengan cara yang berbeda. Beberapa orang menyukai Anda dan belajar lebih baik dari contoh. Beberapa orang menyukai saya dan belajar lebih baik dari dokumentasi terperinci. Memiliki keduanya dalam dokumentasi tampaknya mencakup sebagian besar pengembang dengan cukup baik. Bicaralah dengan seorang guru, mereka dapat memberi tahu Anda setengah lusin cara orang belajar.
sumber