Selamat datang! Repositori ini merupakan wadah bagi semua komponen yang dibutuhkan untuk membuat dokumentasi Kubernetes. Kami merasa sangat senang apabila kamu berminat untuk menjadi kontributor!
Pertama, kamu dapat menekan tombol Fork yang berada pada bagian atas layar, untuk menyalin repositori pada akun Github-mu. Salinan ini disebut sebagai fork. Kamu dapat menambahkan konten pada fork yang kamu miliki, setelah kamu merasa cukup untuk menambahkan konten yang kamu miliki dan ingin memberikan konten tersebut pada kami, kamu dapat melihat fork yang telah kamu buat dan membuat pull request untuk memberi tahu kami bahwa kamu ingin menambahkan konten yang telah kamu buat.
Setelah kamu membuat sebuah pull request, seorang reviewer akan memberikan masukan terhadap konten yang kamu sediakan serta beberapa hal yang dapat kamu lakukan apabila perbaikan diperlukan terhadap konten yang telah kamu sediakan. Sebagai seorang yang membuat pull request, sudah menjadi kewajiban kamu untuk melakukan modifikasi terhadap konten yang kamu berikan sesuai dengan masukan yang diberikan oleh seorang reviewer Kubernetes. Perlu kamu ketahui bahwa kamu dapat saja memiliki lebih dari satu orang reviewer Kubernetes atau dalam kasus kamu bisa saja mendapatkan reviewer Kubernetes yang berbeda dengan reviewer Kubernetes awal yang ditugaskan untuk memberikan masukan terhadap konten yang kamu sediakan. Selain itu, seorang reviewer Kubernetes bisa saja meminta masukan teknis dari reviewer teknis Kubernetes jika diperlukan.
Untuk informasi lebih lanjut mengenai tata cara melakukan kontribusi, kamu dapat melihat tautan di bawah ini:
- Petunjuk Melakukan Kontribusi
- Melakukan Tahap Staging pada Konten Dokumentasi yang telah Kamu Sediakan
- Petunjuk Menggunakan Page Templates
- Petunjuk untuk Documentation Style
- Petunjuk untuk Melakukan Lokalisasi Dokumentasi Kubernetes
Petunjuk yang disarankan untuk menjalankan Dokumentasi Kubernetes pada mesin lokal kamus adalah dengan menggunakan Docker image yang memiliki package Hugo, Hugo sendiri merupakan generator website statis.
Jika kamu menggunakan Windows, kamu mungkin membutuhkan beberapa langkah tambahan untuk melakukan instalasi perangkat lunak yang dibutuhkan. Instalasi ini dapat dilakukan dengan menggunakan Chocolatey.
choco install make
Jika kamu ingin menjalankan website tanpa menggunakan Docker, kamu dapat melihat tautan berikut Petunjuk untuk menjalankan website pada mesin lokal dengan menggunakan Hugo di bagian bawah.
Jika kamu sudah memiliki Docker yang sudah dapat digunakan, kamu dapat melakukan build kubernetes-hugo Docker image secara lokal:
make container-imageSetelah image berhasil di-build, kamu dapat menjalankan website tersebut pada mesin lokal-mu:
make container-serveBuka browser kamu ke http://localhost:1313 untuk melihat laman dokumentasi. Selama kamu melakukan penambahan konten, Hugo akan secara otomatis melakukan perubahan terhadap laman dokumentasi apabila browser melakukan proses refresh.
Kamu dapat melihat dokumentasi resmi Hugo untuk mengetahui langkah yang diperlukan untuk melakukan instalasi Hugo. Pastikan kamu melakukan instalasi versi Hugo sesuai dengan versi yang tersedia pada environment variable HUGO_VERSION pada filenetlify.toml.
Untuk menjalankan laman pada mesin lokal setelah instalasi Hugo, kamu dapat menjalankan perintah berikut:
make serveBuka browser kamu ke http://localhost:1313 untuk melihat laman dokumentasi. Selama kamu melakukan penambahan konten, Hugo akan secara otomatis melakukan perubahan terhadap laman dokumentasi apabila browser melakukan proses refresh.
Kamu dapat belajar bagaimana tata cara untuk ikut terlibat dalam komunitas Kubernetes melalui laman komunitas.
Kamu dapat berinteraksi dengan maintainers project ini melalui:
Partisipasi dalam komunitas Kubernetes diatur dalam Etika dalam Berkontribusi pada Kubernetes.
Kubernetes sangat menjunjung tinggi partisipasi dari komunitas, dan kami sangat mengapresiasi kontribusi kamu pada laman dan dokumentasi kami!