Style Guide

Panduan Penulis

Panduan lengkap untuk kontributor Sitemas. Pelajari gaya penulisan, format artikel, dan best practices untuk membuat konten berkualitas.

Gaya Penulisan

Bahasa

Gunakan Bahasa Indonesia yang baik dengan sentuhan santai. Istilah teknis dalam bahasa Inggris boleh dipertahankan jika lebih umum digunakan (contoh: "framework" bukan "kerangka kerja").

Persona

Tulis dengan sudut pandang "kita" atau "Anda". Hindari "saya" kecuali untuk artikel opini/insight. Contoh: "Kita akan belajar..." atau "Anda bisa menggunakan..."

Nada

Ramah, helpful, dan encouraging. Hindari nada menggurui atau terlalu akademis. Bayangkan sedang membantu teman yang baru belajar.

Kategori Konten

Dokumentasi

Panduan teknis dan referensi. Fokus pada akurasi dan kelengkapan informasi.

Tone: Formal, presisi, terstruktur
Contoh: Cara Install PostgreSQL di Ubuntu 24.04

Tutorial

Panduan step-by-step untuk menyelesaikan task tertentu. Fokus pada proses dan hasil.

Tone: Instruktif, jelas, progresif
Contoh: Membuat REST API dengan FastAPI dari Nol

Insight

Analisis, opini, dan pemikiran tentang teknologi. Fokus pada perspektif dan diskusi.

Tone: Analitis, persuasif, diskursif
Contoh: Mengapa Linux Masih Relevan untuk Developer di 2025

Tips

Quick tips, shortcuts, dan trik. Fokus pada efisiensi dan praktikalitas.

Tone: Ringkas, langsung, praktis
Contoh: 10 Shortcut Terminal yang Wajib Diketahui

Format Artikel

Struktur Umum

  1. Intro (1-2 paragraf) - Jelaskan apa yang akan dibahas dan mengapa penting
  2. Prerequisites (opsional) - Apa yang perlu diketahui/disiapkan pembaca
  3. Konten Utama - Bagi dalam heading H2/H3 yang logis
  4. Kesimpulan - Rangkum poin penting dan berikan next steps

Formatting

  • Gunakan H2 untuk section utama, H3 untuk sub-section
  • Batasi paragraf maksimal 3-4 kalimat
  • Gunakan bullet points untuk list
  • Sertakan code block dengan syntax highlighting yang sesuai
  • Tambahkan gambar/screenshot untuk memperjelas

Code Blocks

```bash
# Selalu sertakan bahasa untuk syntax highlighting
sudo apt update && sudo apt upgrade
```

Frontmatter

Setiap artikel membutuhkan frontmatter YAML di awal file markdown:

Field Required Keterangan
title Ya Judul artikel (50-60 karakter ideal untuk SEO)
description Ya Deskripsi singkat (150-160 karakter)
heroImage Tidak Path ke gambar hero/thumbnail
category Ya Dokumentasi | Tutorial | Insight | Tips
topic Ya Development | Linux | AI & Tools | Gadget | Passive Income | Sitemas | Social Media
tags Ya Array tags (maksimal 5)
publishedAt Ya Tanggal publish (YYYY-MM-DD)
readingTime Ya Estimasi waktu baca (menit)
difficulty Tidak Pemula | Menengah | Lanjutan

Tips Menulis

Gunakan Bahasa Santai

Tulis seperti sedang menjelaskan ke teman. Hindari bahasa terlalu formal atau kaku, tapi tetap profesional.

Jelaskan 'Mengapa'

Jangan hanya tunjukkan cara, tapi jelaskan alasan di balik setiap langkah. Ini membantu pembaca memahami konsep lebih dalam.

Sertakan Contoh Nyata

Code snippet, screenshot, atau studi kasus membuat artikel lebih konkret dan mudah diikuti.

Antisipasi Pertanyaan

Pikirkan pertanyaan yang mungkin muncul dari pembaca dan jawab proaktif di artikel.

Test Sebelum Publish

Khusus untuk tutorial teknis, pastikan semua langkah dan kode berfungsi dengan benar.

Revisi dan Edit

Draft pertama jarang sempurna. Baca ulang, perbaiki struktur, dan kurangi kata-kata yang tidak perlu.

Cara Submit Artikel

1

Tulis Draft

Tulis artikel dalam format Markdown (.md) mengikuti panduan di atas.

2

Self-Review

Baca ulang, cek typo, dan pastikan code/langkah berfungsi.

3

Kirim ke Tim

Email draft ke hello@sitemas.com dengan subject "[Artikel] - Judul Artikel".

4

Review & Publish

Tim akan review, berikan feedback, dan publish jika sudah sesuai.

Siap Berkontribusi?

Mulai menulis artikel pertama Anda dan bergabung dengan komunitas kontributor Sitemas!

Daftar Sebagai Kontributor