Skip to content

Commit 83ab167

Browse files
committed
docs(cookbook): fix cookbook translation and enhancement
1 parent 4131c30 commit 83ab167

File tree

1 file changed

+24
-22
lines changed

1 file changed

+24
-22
lines changed

src/v2/cookbook/index.md

Lines changed: 24 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,30 @@
11
---
2-
title: Introduction
2+
title: Pengantar
33
type: cookbook
44
order: 0
55
---
66

7-
## Buku Petunjuk vs Petunjuk
7+
## Buku Pedoman vs Panduan
88

9-
Bagaimana buku petunjuk berbeda dengan petunjuk? Mengapa hal ini penting?
9+
Bagaimana buku pedoman bisa berbeda dengan Panduan? Mengapa hal ini perlu?
1010

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.
1212

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.
1414

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.
1616

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.
1818

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
2022

2123
### Apa yang kami cari
2224

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.
2426

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.
2628

2729
Instruksi umumnya harus:
2830

@@ -35,25 +37,25 @@ Instruksi umumnya harus:
3537
> * Menjelaskan kelebihan dan kekurangan dari strategi anda, termasuk ketika tepat atau tidak tepat
3638
> * Menyebutkan solusi alternatif, jika relevan, tetapi berikan penjelajahan mendalam untuk instruksi terpisah
3739
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.
3941

40-
### Basis Contoh
42+
### Contoh Dasar
4143

4244
_diwajibkan_
4345

4446
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.
4850

4951
### Detail tentang Nilai
5052

5153
_diwajibkan_
5254

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)
5456
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.
5759

5860
### Contoh Nyata
5961

@@ -70,20 +72,20 @@ Jika anda memilih untuk melakukan yang terakhir, anda masih harus membicarakan a
7072

7173
_opsional_
7274

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.
7476

7577
### Kapan harus menghindari pola ini
7678

7779
_opsional_
7880

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.
8082

8183
### Pola Alternatif
8284

8385
_wajib_
8486

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.
8688

8789
## Terima kasih
8890

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

Comments
 (0)