Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
226 lines (154 loc) · 4.01 KB

CONTRIBUTING.md

File metadata and controls

226 lines (154 loc) · 4.01 KB

Panduan Kontribusi

Terima kasih telah tertarik berkontribusi di Kafekoding Kelas PHP! Ikuti panduan ini untuk memulai.

👥 Siapa yang Bisa Berkontribusi?

  • Peserta aktif Kelas PHP Komunitas Kafekoding
  • Memiliki proyek yang sudah selesai dan berfungsi
  • Bersedia mengikuti panduan kontribusi

📝 Jenis Kontribusi

1. Tambah Materi Pembelajaran

File yang diubah:

  • public/materi/ - Tambah file markdown baru
  • public/materi-list.json - Update daftar materi

Langkah:

  1. Buat file markdown di public/materi/nama-materi.md
  2. Tulis materi dengan format markdown
  3. Tambahkan entry di public/materi-list.json:
{
  "id": 8,
  "slug": "nama-materi",
  "title": "Judul Materi",
  "description": "Deskripsi singkat materi",
  "file": "nama-materi.md",
  "author": "Nama Anda",
  "date": "2026-01-01"
}

2. Tambah Showcase Proyek

File yang diubah:

  • public/showcase.json

Langkah:

Tambahkan entry baru di array showcase:

{
  "id": "proj12",
  "judul": "Project Nama Anda",
  "deks": "Deskripsi singkat proyek Anda",
  "gambar": "https://url-gambar-proyek.jpg",
  "namaPeserta": "Nama Lengkap",
  "tech": ["PHP", "MySQL", "Bootstrap"],
  "github": "https://github.com/username/repo",
  "project": "https://demo-link.com"
}

3. Perbaikan Bug & Improvement

  • Fix responsive design
  • Improve performance
  • Perbaikan typo/dokumentasi
  • Update styling

🔄 Proses Kontribusi

Step 1: Fork Repository

Klik tombol Fork di halaman repository GitHub

Step 2: Clone Repository

git clone https://github.com/USERNAME-ANDA/website.git
cd website

Step 3: Install Dependencies

npm install

Step 4: Buat Branch Baru

Format: Nama_Lengkap_Sekolah

git checkout -b Nama_Lengkap_Sekolah

Contoh:

git checkout -b Budi_Santoso_SMKN1

Step 5: Buat Perubahan

Lakukan perubahan yang diinginkan, lalu test di local:

npm run dev

Step 6: Commit Changes

git add .
git commit -m "feat: deskripsi perubahan"

Format commit message:

Prefix Kegunaan
feat: Fitur baru
fix: Perbaikan bug
docs: Dokumentasi
style: Styling/CSS
chore: Update lainnya

Contoh:

git commit -m "feat: add tutorial array PHP"
git commit -m "fix: responsive navbar mobile"
git commit -m "docs: update README"

Step 7: Push ke Branch

git push origin Nama_Lengkap_Sekolah

Step 8: Buat Pull Request

  1. Buka repository Anda di GitHub
  2. Klik tombol Compare & pull request
  3. Isi judul dan deskripsi PR
  4. Klik Create Pull Request

✅ Checklist Sebelum PR

  • Branch name sesuai format: Nama_Lengkap_Sekolah
  • Commit message jelas dan deskriptif
  • Tidak ada conflict dengan branch main
  • Sudah ditest di local (npm run dev)
  • File JSON valid (tidak ada syntax error)
  • Gambar sudah dioptimasi (jika ada)

📋 Standar Penulisan

Format Materi (Markdown)

# Judul Materi

Pengenalan singkat tentang materi...

---

## Apa itu [Topik]?

Penjelasan detail...

## Contoh Kode

```php
<?php
echo "Hello World";
?>

Kesimpulan

Ringkasan materi...


### Format JSON

- Gunakan lowercase dengan hyphen untuk `slug` dan `file`
- Gunakan format tanggal `YYYY-MM-DD`
- Pastikan JSON valid sebelum commit

---

## ⏱️ Review Process

- Tim maintainer akan review PR dalam 3-7 hari
- Mungkin ada feedback atau request perubahan
- Setelah approved, PR akan di-merge ke main

---

## 🏆 Kontributor

Nama Anda akan masuk ke daftar kontributor setelah PR di-approve!

| Nama | Sekolah/Kampus | Kontribusi |
|------|----------------|------------|
| M. Rifaldo Saputra | Metamedia | Lead Developer |
| *Nama Anda* | *Sekolah* | *Kontribusi* |

---

## ❓ Pertanyaan?

Hubungi mentor:

- GitHub: [@rifaldo-dev](https://github.com/rifaldo-dev)
- Instagram: [@rifaldo.dev](https://www.instagram.com/rifaldo.dev)

---

Selamat berkontribusi! 🚀