You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Bagaimana buku petunjuk berbeda dengan petunjuk? Mengapa hal ini penting?
9
+
Bagaimana buku pedoman bisa berbeda dengan Panduan? Mengapa hal ini perlu?
10
10
11
-
***Fokus Yang Lebih Baik**: Di dalam petunjuk, kami pada dasarnya bercerita.Setiap bagian dibangun dan diasumsikan dari tiap bagian sebelumnya. Di dalam buku petunjuk, setiap instruksi bisa dan harus berdiri sendiri. Ini berarti instruksi dapat fokus pada satu aspek spesifik Vue, daripada harus memberikan gambaran umum.
11
+
***Fokus yang Lebih Baik**: Dalam panduan, pada dasarnya kita menceritakan sebuah cerita. Dalam panduan ini, pada dasarnya kami sedang bercerita.Setiap bagian dibangun di atas dan mengasumsikan pengetahuan dari setiap bagian sebelumnya. Dalam buku pedoman, setiap petunjuk dapat dan harus berdiri sendiri. Ini berarti buku pedoman dapat fokus pada satu aspek spesifik Vue, daripada harus memberikan gambaran umum.
12
12
13
-
***Lebih Mendalam**: Untuk menghindari membuat panduan lebih panjang, kami mencoba untuk hanya menyertakan contoh paling sederhana untuk membantu anda memahami setiap fitur. Lalu kami melanjutkan. Di dalam buku petunjuk, kami bisa menyertakan lebih banyak contoh kompleks, menggabungkan fitur dengan cara yang menarik. Setiap instuksi juga bisa menjadi panjang dan rinci sesuai yang dibutuhkan, demi mendalami topik secara menyeluruh.
13
+
***Kedalaman yang Lebih Baik**: Untuk menghindari membuat Panduan terlalu lama, kami mencoba menyertakan hanya contoh sederhana untuk membantu anda memahami setiap fitur. Kemudian kita melanjutkan. Dalam buku pedoman, kita dapat memasukkan contoh yang lebih kompleks, menggabungkan fitur dengan cara yang menarik. Setiap petunjuk juga bisa sepanjang dan sedetail yang dibutuhkan, sesuai yang dibutuhkan, untuk sepenuhnya menjelajahi ceruknya.
14
14
15
-
***Mengajarkan JavaScript**: Di dalam petunjuk, kami berasumsi bahwa setidaknya sudah terbiasa dengan ES5 JavaScript. Sebagai contoh, kami tidak akan menjelaskan bagaimana `Array.prototype.filter` bekerja pada properti _computed_ yang menyaring sebuah daftar.
15
+
***Mengajarkan JavaScript**: Dalam Panduan ini, kami mengasumsikan setidaknya mengenal ES5 JavaScript secara menengah. Sebagai contoh, kami tidak akan menjelaskan bagaimana `Array.prototype.filter` bekerja pada properti komputasi yang memfilter daftar. Namun dalam buku pedoman, fitur JavaScript penting (termasuk ES6/2015 ) dapat dieksplorasi dan dijelaskan dalam konteks bagaimana mereka membantu kita membangun aplikasi Vue yang lebih baik.
16
16
17
-
***Menjelajahi Ekosistem**: Untuk fitur tingkat lanjut, kami mengasumsikan beberapa pengetahuan ekosistem. Sebagai contoh, jika anda ingin menggunakan komponen berkas tunggal (single-file components) di Webpack, kami tidak menjelaskan bagaimana cara untuk mengkonfigurasi selain bagian dari Vue pada konfigurasi Webpack. Di dalam buku petunjuk, kami memiliki ruang untuk menjelajahi pustaka ekosistem lebih dalam - setidaknya selama berguna secara universal bagi pengembang Vue.
17
+
***Menjelajahi Ekosistem**: Untuk fitur tingkat lanjut, kami mengasumsikan beberapa pengetahuan ekosistem. Misalnya, jika Anda ingin menggunakan komponen file tunggal di Webpack, kami tidak menjelaskan cara mengonfigurasi bagian non-Vue dari konfigurasi Webpack.Dalam buku masak, kami memiliki ruang untuk menjelajahi perpustakaan ekosistem ini secara lebih mendalam - setidaknya sejauh yang secara universal berguna bagi pengembang Vue.
18
18
19
-
## Kontribusi Buku Petunjuk
19
+
Dengan semua perbedaan ini, harap dicatat bahwa buku pedoman masih bukan manual langkah demi langkah. Untuk sebagian besar kontennya, Anda diharapkan memiliki pemahaman dasar tentang konsep-konsep seperti HTML, CSS, JavaScript, npm/yarn, dll.
20
+
21
+
## Kontribusi buku pedoman
20
22
21
23
### Apa yang kami cari
22
24
23
-
Buku petunjuk memberikan contoh kepada pengembang untuk mengatasi kasus penggunaan umum atau menarik, dan juga menjelaskan detail yang lebih kompleks. Tujuan kami adalah untuk melampaui contoh pengantar sederhana, dan menunjukkan konsep yang lebih luas yang bisa diterapkan, dan beberapa peringatan untuk pendekatan.
25
+
buku pedoman memberikan contoh kepada pengembang untuk mengatasi kasus penggunaan umum atau menarik, dan juga secara progresif menjelaskan detail yang lebih kompleks. Tujuan kami adalah untuk bergerak melampaui contoh pengantar sederhana, dan menunjukkan konsep-konsep yang lebih luas berlaku, serta beberapa peringatan untuk pendekatan tersebut.
24
26
25
-
Jika anda tertarik untuk berkontribusi, silakan mulai kolaborasi dengan cara mengisi sebuah isu dibawah tanda **ide buku petunjuk** dengan konsep anda sehingga kami bisa memandu anda untuk melakukan _pull request_ dengan sukses. Setelah ide anda disetujui, silakan ikuti templat dibawah ini sebanyak mungkin. Beberapa bagian diperlukan, dan lainnya adalah opsional. Mengikuti urutan penomoran sangat disarankan, tetapi tidak diwajibkan.
27
+
Jika Anda tertarik untuk berkontribusi, silakan mulai kolaborasi dengan mengajukan masalah di bawah **ide buku pedoman** dengan konsep anda sehingga kami dapat membantu memandu Anda untuk melakukan _pull request_ dengan sukses. Setelah ide anda disetujui, silakan ikuti template dibawah ini sebanyak mungkin. Beberapa bagian diperlukan, dan beberapa opsional. Mengikuti urutan numerik sangat disarankan, tetapi tidak diperlukan.
26
28
27
29
Instruksi umumnya harus:
28
30
@@ -35,25 +37,25 @@ Instruksi umumnya harus:
35
37
> * Menjelaskan kelebihan dan kekurangan dari strategi anda, termasuk ketika tepat atau tidak tepat
36
38
> * Menyebutkan solusi alternatif, jika relevan, tetapi berikan penjelajahan mendalam untuk instruksi terpisah
37
39
38
-
Kami memohon anda untuk mengikuti templat dibawah ini. Kami mengerti, namun, bahwa ada saat ketika anda perlu menyimpang demi kejelasan maupun aliran. Bagaimanapun juga, semua instruksi pada suatu titik tertentu harus mendiskusikan nuansa pilihan yang dibuat menggunakan pola ini, lebih disukai dalam bentuk bagian pola alternatif.
40
+
Kami meminta Anda untuk mengikuti template di bawah ini. Kami memahami, bagaimanapun, bahwa ada kalanya Anda mungkin perlu menyimpang untuk kejelasan atau aliran. Bagaimanapun juga, semua petunjuk pada titik tertentu harus membahas nuansa pilihan yang dibuat menggunakan pola ini, lebih disukai dalam bentuk bagian pola alternatif.
39
41
40
-
### Basis Contoh
42
+
### Contoh Dasar
41
43
42
44
_diwajibkan_
43
45
44
46
1. Mengartikulasikan masalah dalam satu atau dua kalimat.
45
-
2.Menjelaskan cara paling sederhana dalam satu atau dua kalimat.
46
-
3.Menampilkan contoh kecil kode.
47
-
4. Jelaskan apa yang dicapai dalam satu kalimat.
47
+
2.Jelaskan solusi sesederhana mungkin dalam satu atau dua kalimat.
48
+
3.Memperlihatkan contoh kecil kode.
49
+
4. Jelaskan apa yang dicapai dalam sebuah kalimat.
48
50
49
51
### Detail tentang Nilai
50
52
51
53
_diwajibkan_
52
54
53
-
1.Jawab pertanyaan umum yang mungkin dimiliki seseorang saat melihat contoh. (Blockquote bagus untuk hal ini)
55
+
1.Jawablah pertanyaan umum yang mungkin dimiliki seseorang saat melihat contoh tersebut. (Blockquotes sangat bagus untuk ini)
54
56
2. Tunjukkan contoh kesalahan langkah umum dan bagaimana mereka dapat dihindari.
55
-
3.Perlihatkan contoh kode yang sangat sederhana dari pola yang baik dan buruk.
56
-
4. Diskusikan mengapa ini bisa menjadi pola yang meyakinkan. Tautan untuk referensi tidak diwajibkan tetapi dianjurkan.
57
+
3.Tampilkan sampel kode yang sangat sederhana dari pola yang baik dan buruk.
58
+
4. Diskusikan mengapa ini mungkin merupakan pola yang menarik. Tautan untuk referensi tidak diwajibkan tetapi dianjurkan.
57
59
58
60
### Contoh Nyata
59
61
@@ -70,20 +72,20 @@ Jika anda memilih untuk melakukan yang terakhir, anda masih harus membicarakan a
70
72
71
73
_opsional_
72
74
73
-
Sangat membantu untuk menuliskan sedikit tentang pola ini, di mana ini akan berlaku, mengapa ini bekerja dengan baik, dan menjalankan sedikit kode saat anda melakukannya atau memberikan orang bahan bacaan lebih lanjut di sini.
75
+
Sangat membantu untuk menuliskan sedikit tentang pola ini, di mana lagi itu akan berlaku, mengapa itu bekerja dengan baik, dan menjalankan sedikit kode saat Anda melakukannya atau memberi orang bahan bacaan lebih lanjut di sini.
74
76
75
77
### Kapan harus menghindari pola ini
76
78
77
79
_opsional_
78
80
79
-
Bagian ini tidak diwajibkan, tetapi sangat direkomendasikan. Tidak masuk akal untuk menuliskan sesuatu yang sangat sederhana seperti mengubah kelas berdasarkan perubahan _state_, tetapi untuk pola tingkat lanjut seperti mixins, ini sangat penting. Jawaban untuk sebagian besar pertanyaan tentang pengembangan adalah ["Tergantung!"](https://codepen.io/rachsmith/pen/YweZbG), bagian ini mencakup itu. Disini, kami akan menilai secara jujur apakah pola ini berguna dan kapan harus dihindari, atau ketika hal lain lebih masuk akal.
81
+
Bagian ini tidak diwajibkan, tetapi sangat disarankan. Tidak masuk akal untuk menuliskan sesuatu yang sangat sederhana seperti mengubah kelas berdasarkan perubahan _state_, tetapi untuk pola tingkat lanjut seperti mixins, ini sangat penting. Jawaban untuk sebagian besar pertanyaan tentang pengembangan adalah ["Tergantung!"](https://codepen.io/rachsmith/pen/YweZbG), bagian ini mencakup itu. Disini, kami akan menilai secara jujur apakah pola ini berguna dan kapan harus dihindari, atau ketika hal lain lebih masuk akal.
80
82
81
83
### Pola Alternatif
82
84
83
85
_wajib_
84
86
85
-
Bagian ini diwajibkan ketika anda telah memberikan bagian diatas tentang penghindaran. Penting untuk mengeksplorasi metode lain sehingga orang-orang mengatakan bahwa sesuatu adalah anti-pola dalam situasi tertentu tidak dibiarkan bertanya-tanya. Dengan demikian, pertimbangkan bahwa web adalah tenda besar dan banyak orang memiliki struktur basis kode yang berbeda dan menyelesaikan tujuan yang berbeda. Apakah aplikasinya besar atau kecil? Apakah mereka mengintegrasikan Vue ke proyek yang ada, atau mereka membangun dari awal? Apakah pengguna mereka hanya berusaha mencapai satu tujuan atau banyak? Apakah ada banyak data yang tidak sinkron? Semua masalah ini akan berdampak pada implementasi alternatif. Buku petunjuk yang bagus memberi konteks ini pada pengembang.
87
+
Bagian ini diwajibkan ketika anda telah memberikan bagian diatas tentang penghindaran. Penting untuk mengeksplorasi metode lain sehingga orang-orang mengatakan bahwa sesuatu adalah anti-pola dalam situasi tertentu tidak dibiarkan bertanya-tanya. Dengan demikian, pertimbangkan bahwa web adalah tenda besar dan banyak orang memiliki struktur basis kode yang berbeda dan menyelesaikan tujuan yang berbeda. Apakah aplikasinya besar atau kecil? Apakah mereka mengintegrasikan Vue ke proyek yang ada, atau mereka membangun dari awal? Apakah pengguna mereka hanya berusaha mencapai satu tujuan atau banyak? Apakah ada banyak data yang tidak sinkron? Semua masalah ini akan berdampak pada implementasi alternatif. buku pedoman yang bagus memberi konteks ini pada pengembang.
86
88
87
89
## Terima kasih
88
90
89
-
Memakan waktu untuk berkontribusi pada dokumentasi, dan jika anda meluangkan waktu untuk mengirimkan PR ke bagian dokumen ini, anda melakukannya dengan rasa terima kasih kami.
91
+
butuh waktu untuk berkontribusi pada dokumentasi, dan jika anda meluangkan waktu untuk mengirimkan PR ke bagian dokumen kami ini, anda melakukannya dengan rasa terima kasih kami.
0 commit comments