Halaman ini berisi detail project penulisan teknis yang diterima untuk Google Season of Docs.
Ringkasan project
- Organisasi open source:
- Whonix
- Penulis teknis:
- 0brand
- Nama project:
- Mendokumentasikan Penginstalan dan Penyiapan Distribusi Linux Debian yang Diperkuat dan Berfokus pada Keamanan.
- Durasi project:
- Durasi standar (3 bulan)
Deskripsi project
Debian yang Diperkuat adalah distribusi Linux baru yang berfokus pada keamanan dan sedang dalam pengembangan aktif oleh developer Whonix. Project ini mendokumentasikan penginstalan dan penyiapan Debian yang Diperkuat di dalam Windows/VirtualBox dari awal, dengan fokus mendidik pengguna Linux pemula dengan keterampilan yang mereka butuhkan untuk mandiri saat menggunakan distribusi Linux.
Sasaran Project
Membuat Dokumentasi Inti
Fase awal project ini akan berfokus pada dokumentasi inti untuk Debian yang Diperkuat. Dokumentasi ini akan terdiri dari Ringkasan Project Komprehensif, Tutorial untuk menginstal dan menyiapkan Debian yang Diperkuat, serta saran dan tips pasca-penginstalan.
Membuat Area Pembelajaran untuk Pengguna Linux Baru
Mengajarkan pengguna Linux baru bukan hanya tentang menulis beberapa halaman manual dan menyebutnya sebagai area pendidikan. Banyak pemula tidak terbiasa berinteraksi dengan perintah dan memecahkan masalah mereka sendiri. Halaman ini akan berfokus pada keterampilan CLI, pemecahan masalah praktis, dan praktik terbaik pemecahan masalah.
Memisahkan Dokumentasi Debian yang Diperkuat dari Dokumentasi Whonix (OS Anonimitas) dengan Jelas:
Meskipun Whonix.org akan menjadi tempat untuk Whonix dan Debian yang Diperkuat, setiap OS memiliki kasus penggunaan yang sangat berbeda yang dapat menyebabkan konsekuensi serius jika pengguna mengira salah satunya adalah yang lain. Misalnya, Whonix dikenal dengan anonimitasnya, tetapi pengguna baru yang tidak terbiasa dengan Whonix mungkin menyiapkan Debian yang Diperkuat dan mengira mereka menjelajahi Web secara anonim. Untuk mencegah jenis kesalahan ini, dokumentasi Debian yang Diperkuat akan dibatasi ke area terpisah di Whonix.org menggunakan gaya pemformatan baru seperti buku yang berbeda dari gaya pemformatan dokumentasi Whonix OS. Peringatan juga akan disertakan di area utama seperti halaman download Debian yang Diperkuat untuk mencegah pengguna melakukan kesalahan ini.
Dokumentasi yang Mudah Digunakan
Penginstalan dan penyiapan distribusi Linux dapat menjadi tantangan bahkan bagi pengguna berpengalaman. Meskipun UI yang mudah digunakan dan intuitif dapat meningkatkan pengalaman pengguna, yang sama pentingnya adalah menulis dokumentasi yang jelas dan mudah diikuti -- Mudah Digunakan. Karena basis pengguna Debian yang Diperkuat berkisar dari pemula hingga pengguna Linux tingkat lanjut, dokumentasi harus dibuat dengan hati-hati agar tidak hanya didasarkan pada keahlian teknis dan pemahaman penulis teknis. Sebagai gantinya, Debian yang Diperkuat akan didokumentasikan dari perspektif pemula Linux yang mungkin mengalami kesulitan dalam melakukan tugas yang dianggap sederhana dan mudah diselesaikan oleh pengguna berpengalaman.
Mendorong Keterlibatan/Kontribusi Komunitas
Debian yang Diperkuat adalah project yang menantang dan hanya dapat diselesaikan sepenuhnya dengan memastikan komunitas tetap terlibat selama durasi project. Anggota komunitas akan tetap terlibat hanya jika masukan mereka disambut dengan antusiasme dan ide-ide bagus mereka digunakan untuk meningkatkan dokumentasi. Selama GSoD, saya akan tetap aktif di forum Whonix untuk mendorong masukan dan kontribusi komunitas guna meningkatkan dokumentasi.
Mengganti Nama OS Debian yang Diperkuat
Meskipun sistem operasi ini didasarkan pada Debian yang Diperkuat, nama baru harus ditemukan untuk menghindari pelanggaran merek dagang. Untuk mencapai sasaran ini, komunitas Whonix akan didorong untuk mengirimkan nama-nama menarik yang dapat dipilih oleh developer Whonix. Meskipun masih dalam mode brainstorming, dua pilihan teratas saya adalah ""Sentient Linux"" dan ""Sentinel Linux"".
Jangka Waktu Project
Jangka waktu project ini akan dibagi menjadi 7 tonggak pencapaian mini yang dapat digunakan untuk mengukur progres dan memungkinkan penyesuaian dilakukan untuk memastikan setiap bagian diselesaikan tepat waktu. Jika kesulitan muncul kapan saja selama Season of Docs, saya akan segera memberi tahu mentor saya sehingga rencana tindakan dapat dirumuskan untuk menyelesaikan masalah tersebut.
02 Sep ( Mulai Project Season of Docs)
Halaman beranda akan memberikan ringkasan tentang Debian yang Diperkuat yang menjelaskan poin-poin utama OS.
Dokumentasi awal akan terdiri dari penginstalan Debian yang Diperkuat di Windows/VirtualBox. Hal ini akan membatasi cakupan awal bab ini. Namun, anggota komunitas akan didorong untuk menguji Debian yang Diperkuat di host Linux serta hypervisor KVM dan mendokumentasikan temuan mereka.
Tabel yang Menjelaskan Sistem Operasi Host yang Didukung
Tabel yang menjelaskan persyaratan hardware.
- Persyaratan minimum
- Direkomendasikan
- Untuk performa terbaik
Konten akan terdiri dari ringkasan yang menjelaskan sasaran pengembangan dan penggunaan Debian yang Diperkuat, diikuti dengan tabel yang menguraikan setiap komponen.
Sasaran Debian yang Diperkuat.
- Distribusi Linux yang berfokus pada keamanan
- Gratis dan open source
- Dapat dikonfigurasi pengguna
- Diperkuat secara default
Tabel komponen yang membentuk Debian yang Diperkuat.
- Hypervisor VirtualBox
- Windows
- OS berbasis Debian yang Diperkuat
- Terminologi (host, virtual machine, OS tamu, dll.)
Debian yang Diperkuat dikonfigurasi dengan banyak fitur keamanan lanjutan secara default. Hal ini menghilangkan kebutuhan pengguna untuk mencari konfigurasi yang sering kali rumit. Semua peningkatan keamanan akan dijelaskan dalam tabel dengan penjelasan singkat tentang manfaatnya.
- Haveged diinstal secara default untuk entropi yang lebih baik.
- Sinkronisasi Waktu Jaringan Terdistribusi yang Aman (sdwdate) digunakan, bukan NTP.
- Menonaktifkan pratinjau di Dolphin, Nautilus.
- Menonaktifkan stempel waktu TCP dan helper pelacakan koneksi Netfilter.
- open-link-confirmation.
- Apparmor diaktifkan secara default dengan profil.
- Browser yang diperkuat keamanannya (Tor Browser tanpa Tor)
Kernel Linux yang ditingkatkan
Lingkungan desktop; KDE (Hanya tersedia di CLI).
Lainnya ...
Tonggak Pencapaian 15 Sep (Menyelesaikan Persyaratan Sistem, Fitur dan Keunggulan, Desain, dan Sasaran)
Halaman FAQ akan digunakan untuk menjawab pertanyaan yang sering diajukan oleh anggota komunitas. Konten akan ditambahkan sesuai kebutuhan selama durasi project.
Download dan penginstalan Debian yang Diperkuat akan terdiri dari hal berikut.
- Tabel download yang berisi image Debian yang Diperkuat, tanda tangan OpenGPG, hash sha512, dan kunci penandatanganan GPG developer.
- Memverifikasi kunci penandatanganan developer dan image sistem operasi (tutorial).
- Download dan verifikasi hypervisor VirtualBox (tutorial).
- Mengimpor Debian yang Diperkuat di VirtualBox (tutorial)
- Memulai Debian yang Diperkuat
Tonggak Pencapaian 29 Sep (Menyelesaikan Download dan Verifikasi Image Debian, Penginstalan Debian)
Pengguna mungkin tidak terbiasa dengan langkah-langkah yang diperlukan untuk menyesuaikan lingkungan desktop dan mengalokasikan resource sistem. Tips ""konfigurasi cepat"" akan didokumentasikan untuk setiap hal berikut.
- Mengubah Tata Letak Keyboard
- Mengalokasikan resource sistem tambahan (RAM)
- Mengubah resolusi layar
- Pintasan desktop
- Pengelola gaya jendela
Bug dan masalah yang ditemukan selama pengujian OS dan tutorial akan didokumentasikan dengan jelas beserta solusinya. Halaman ini juga akan menyertakan masalah umum saat menjalankan sistem operasi di hypervisor.
- Masalah RAM rendah
- Kesalahan konfigurasi BIOS (Intel VT-d, AMD-V)
- Masalah konektivitas
Tonggak Pencapaian 6 Okt (Menyelesaikan Langkah Pertama, Bug Debian yang Diperkuat)
Pengguna baru mungkin tidak terbiasa dengan terminal/CLI Linux. Jika informasi yang mereka butuhkan tidak mudah ditemukan atau diakses, mereka akan membuka permintaan dukungan tanpa mencoba menemukan solusinya. Bagian ini akan mendokumentasikan perintah yang umum digunakan dan sintaksis perintah praktis. Setiap man akan memberikan ringkasan singkat tentang perintah, cara menggunakannya beserta contoh praktis. Pengguna memerlukan waktu untuk mengingat perintah yang harus mereka gunakan untuk berbagai tugas. Melalui pengulangan, pengguna akan mengingat sintaksis perintah dari waktu ke waktu.
- Terminal/CLI
- sudo
- Editor teks
- Struktur direktori
- Navigasi sistem file
- Izin file
- Halaman manual
- Membuat file/direktori
- Lain-lain (ls, cat, less)
Tonggak Pencapaian 22 Okt (Menyelesaikan Area Pembelajaran, halaman manual)
Pengguna Linux yang kompeten/berpengalaman memiliki keterampilan memecahkan masalah yang baik yang mereka peroleh dari waktu ke waktu. Saat masalah muncul, mereka akan otomatis mulai mencari solusi, dan terus mencari hingga menemukan jawaban atau semua kemungkinan resource telah habis. Saat pengguna Linux baru mengalami masalah, mereka akan otomatis membuka permintaan dukungan. Sangat penting untuk memperkuat praktik yang baik sejak awal.
Template pemecahan masalah : Pengguna cenderung berhasil saat memecahkan masalah jika mereka mengikuti petunjuk langkah demi langkah. Hal ini akan berfokus pada cara mengumpulkan informasi yang relevan dan cara menggunakan informasi tersebut untuk menemukan solusi atas masalah mereka. Hal ini akan serupa.
Memantau file log: Lokasi log sistem (untuk apa setiap log digunakan) dan perintah yang diperlukan untuk mempersempit output CLI. (journalctl, dmesg, dll.)
systemd: status, memulai dan menghentikan layanan.
Memecahkan masalah umum: Masalah koneksi, paket software yang rusak, dll.
Pedoman pelaporan bug dan/atau masalah.
Tonggak Pencapaian 05 Nov (Menyelesaikan Area Pembelajaran, Pemecahan Masalah)
Sisa Summer of Docs akan berfokus pada refactoring dokumentasi Whonix untuk Debian yang Diperkuat, dan kontrol kualitas.
Memfaktorkan Ulang Dokumen Whonix untuk digunakan dengan Debian yang Diperkuat
- Menginstal Software dengan Aman.
- Pembaruan Sistem Operasi