🤝 Panduan Kontribusi untuk Layar Kosong

Membangun perangkat lunak yang hebat tidak hanya butuh kecerdasan teknis, melainkan juga fondasi komunitas yang sehat. Proyek Layar Kosong ibarat rumah digital kita bersama, dan kami sangat berkomitmen untuk menjaga lingkungannya agar tetap terbuka, ramah, dan inklusif bagi siapa saja tanpa pandang bulu. Pada intinya, kita semua di sini adalah sekumpulan kawan yang dipersatukan oleh satu niat baik.

Prinsip dasar kami adalah selalu mengedepankan prasangka baik (assume good intent). Dalam diskusi teknis, perbedaan pendapat itu sangat lumrah dan justru menyehatkan. Namun, perdebatan tersebut harus selalu dilandasi rasa saling menghormati dan dibalut dengan sikap profesional. Dilarang keras menggunakan kata-kata kasar atau melontarkan serangan personal kepada sesama kontributor.

Jika dalam perjalanannya kamu menemukan komentar, issue, atau melihat perilaku dari anggota lain yang dirasa kurang pantas atau melanggar norma komunitas, jangan dipendam sendiri. Segera laporkan kejadian tersebut melalui pesan atau diskusi pribadi langsung kepada pengelola repositori di GitHub. Privasi dan kenyamananmu adalah prioritas mutlak yang akan kami jaga.

Untuk rincian yang lebih formal dan komprehensif, kami sangat mewajibkan seluruh calon kontributor untuk membaca serta mematuhi dokumen CODE_OF_CONDUCT kami. Aturan ini bukanlah pajangan, melainkan pedoman krusial demi memastikan proyek ini terus berjalan dalam harmoni.

Eits, jangan salah sangka dulu! Berkontribusi di dunia open source itu tidak melulu soal menulis baris kode yang rumit, lho. Ekosistem Layar Kosong menyediakan ruang luas dengan berbagai peran seru yang bisa kamu ambil untuk membantu proyek ini agar tampil makin kece.

1. Pelaporan Bug (Masalah) 🐛

Pernah menemukan elemen yang tumpang tindih (overlap), warna yang menyiksa mata, tautan yang tiba-tiba putus (broken link), atau error aneh saat mengakses halaman Layar Kosong? Nah, insting detektifmu sedang dibutuhkan di sini!

• Gunakan fitur tab Issues di GitHub sebagai jalur resmi untuk melaporkan segala bentuk bug.
• Sajikan deskripsi kasus yang sangat jelas. Ceritakan kronologi kejadiannya, sebutkan peramban (browser) yang kamu pakai, dan jabarkan langkah-langkah presisi untuk mereproduksi bug tersebut agar tim kami bisa segera mengujinya.
• Jangan lupa untuk menyematkan label yang relevan (misalnya label bug atau needs triage) agar tiket laporanmu mudah disortir oleh para maintainer.

2. Diskusi & Brainstorming Ide Baru 💡

Punya ide segar gila untuk fitur baru? Menemukan trik optimasi SEO yang belum kami terapkan? Atau sekadar ingin mengobrol seputar tren teknologi HTML/CSS murni terkini? Jangan biarkan ide brilian itu menguap begitu saja!

• Langsung saja meluncur ke tab Discussions di GitHub.
• Forum ini didesain khusus sebagai tempat nongkrong digital untuk mematangkan konsep, mengkritisi desain, dan menyempurnakan alur logika sebelum kamu mulai menulis satu baris kode pun. Siapa tahu, lemparan gagasamulah yang akan melahirkan fitur killer kami berikutnya.

3. Kontribusi Kode (Pull Request) 💻

Oke, buat kamu para praktisi yang jari-jarinya gatal ingin langsung terjun mengoprek kerangka sistem, ini dia panduan teknis yang kamu tunggu-tunggu! Mulai dari perbaikan algoritma, pembaruan workflow automation, hingga sekadar merapikan margin CSS, semuanya akan kami sambut dengan pintu terbuka.

A. Persiapan Alur Kerja (Git Workflow)

1. Langkah paling awal, lakukan Fork repositori utama ini ke akun GitHub pribadimu. Anggap saja kamu sedang menyalin buku catatan agar bebas dicoret-coret tanpa merusak aslinya.
2. Setelah itu, lakukan Clone repositori hasil fork tersebut ke komputer lokalmu agar kamu bisa bekerja secara offline di code editor kesayanganmu.
3. Selalu biasakan membuat branch (cabang) baru sebelum mengubah apa pun. Gunakan penamaan yang deskriptif, misalnya: feat/optimasi-gambar atau fix/navigasi-mobile. Praktik ini sangat vital untuk mencegah konflik pembaruan (merge conflict) di masa mendatang.

B. Standar Penulisan Kode

• HTML & Markdown: Filosofi kami adalah kesederhanaan (simplicity) dan kebersihan. Pastikan struktur HTML-mu lulus validasi semantik, terindentasi dengan rapi, dan mudah dibaca oleh manusia.
• CSS: Karena arsitektur proyek ini adalah situs statis tanpa kerangka kerja (framework) besar demi mengejar performa secepat kilat, usahakan hanya menggunakan CSS murni yang efisien. Hindari properti yang rakus memori. Pendekatan gaya inline atau scoped pada tag <style> sangat kami rekomendasikan. Ingat, minimalis itu indah!
• Workflow YAML: Jika kamu memodifikasi alur kerja otomatis (GitHub Actions) berformat .yml, lakukan uji coba secara teliti di repositori pribadimu terlebih dahulu untuk memastikan skrip tersebut berjalan tanpa error dan aman dari celah eksploitasi.

C. Prosedur Mengirimkan Pull Request (PR)

Ketika karyamu dirasa sudah rampung dan lulus uji, saatnya mempresentasikan kode tersebut kepada kami:

• Pastikan riwayat commit-mu memiliki pesan log yang spesifik dan konvensional. Contoh yang baik:
  

  fix: Perbaiki tautan favicon yang rusak di halaman utama

  atau
  

  feat: Tambahkan GitHub Action otomatis untuk ping sitemap ke Google

• Buka jendela Pull Request, lalu arahkan perubahan dari branch kamu ke branch main milik repositori Layar Kosong utama.
• Deskripsikan PR-mu secara detail. Ceritakan motivasimu: Masalah apa yang kamu selesaikan? Mengapa pendekatan ini yang kamu pilih? Dan apa hasil akhir dari perubahan ini? Dokumentasi PR yang rapi akan mempercepat proses tinjauan (review) oleh tim maintainer.

Layar Kosong bukanlah semata-mata repositori kode, melainkan wadah publikasi konten berbasis HTML murni yang dirancang untuk edukasi. Oleh karena itu, para penggiat literasi, blogger, dan praktisi teknis sangat dipersilakan untuk menyumbangkan tulisan, panduan, atau opini teknis mereka di sini. Bagikan wawasan mahalmu kepada komunitas!

Alur teknis untuk memublikasikan tulisanmu sangatlah lugas:

1. Buatlah sebuah berkas HTML tunggal yang baru (sebagai contoh: artikel-tutorial-git-pemula.html). Pastikan kamu mematuhi struktur semantik HTML5 seperti yang sudah dicontohkan pada template dasar kami.
2. Letakkan berkas HTML yang sudah jadi tersebut ke dalam direktori artikelx/.
3. Kirimkan tulisan tersebut melalui jalur Pull Request dengan mengikuti panduan Git Workflow yang sudah kita bahas sebelumnya.

⚠️ Deklarasi Penting Mengenai Lisensi: Proyek Layar Kosong sepenuhnya beroperasi di bawah naungan lisensi UNLICENSE (Dedikasi Public Domain). Ini adalah komitmen serius. Konsekuensinya, saat kamu dengan sadar mengirimkan karya artikelmu ke dalam folder artikelx/, kamu secara otomatis melepaskan seluruh hak cipta dan kepemilikan eksklusif atas tulisan tersebut kepada Domain Publik internasional. Siapa pun bebas menggunakan, menyalin, memodifikasi, dan mendistribusikan ulang karyamu tanpa syarat. Pastikan kamu benar-benar nyaman dan ikhlas dengan kebijakan fundamental ini sebelum menekan tombol submit ya! Terima kasih banyak atas kelapangan hatimu. 🙏