Halaman ini diterjemahkan oleh Cloud Translation API.

Project FreeBSD

Halaman ini berisi detail project penulisan teknis yang diterima untuk Google Season Dokumen.

Ringkasan proyek

Organisasi open source:: Project FreeBSD
Penulis teknis:: kuafein
Nama proyek:: Buat segmen buku panduan Wine
Durasi proyek:: Durasi standar (3 bulan)

Project description

Sebagai bagian dari inisiatif ini, saya akan menghasilkan bab yang mendalam dan panjang panduan dari Buku Pegangan FreeBSD yang terkait dengan instalasi, penggunaan, dan pemecahan masalah WINE (www.winehq.org) di FreeBSD. Saya akan meluangkan waktu 4-8 jam setiap minggu untuk mengerjakan item di bawah ini, kecuali jika dinyatakan lain.

*** Ikatan Komunitas

Jika terpilih, saya akan menghabiskan periode Ikatan Komunitas untuk membiasakan diri dengan proses dokumentasi dan infrastruktur project FreeBSD. Saya selalu terkesan dengan dokumentasi kohesif yang dikeluarkan oleh proyek, dan saya terlibat dengan anggota tim proyek mengenai alur kerja mereka. Saya juga akan bergabung dan menjelajahi forum yang berorientasi pengguna untuk mengetahui apa yang dapat membantu pengguna FreeBSD dalam hal dokumentasi secara umum, dan khususnya membantu bekerja dengan WINE pada FreeBSD.

Saya akan meluangkan waktu selama periode ini untuk mempelajari toolchain dokumentasi project. Dengan begitu, saya dapat mulai bekerja selama minggu-minggu awal proyek jika saya terpilih.

*** Minggu 1 (14-9-19): Uji Instalasi & Pemecahan Masalah

Saya akan menghabiskan minggu pertama fase Pengembangan Dokumen melakukan instalasi uji coba WINE pada versi stabil FreeBSD saat ini, serta menginstal dan menjalankan berbagai aplikasi Windows mulai dari utilitas sederhana hingga aplikasi yang lebih kompleks. Ini adalah pendekatan yang saya ambil dalam artikel serupa yang saya lakukan di ReactOS for MakeUseOf (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/), hanya saya akan menggunakan waktu minggu pertama untuk memeriksa lebih banyak pilihan program.

Menurut pengalaman saya, menghabiskan waktu semacam ini di awal berguna untuk mengidentifikasi (dan memecahkan) jenis masalah ""gotcha"" yang umum. Dengan cara ini, saya dapat memiliki solusi saat benar-benar tiba waktunya untuk menulis bagian yang relevan, atau setidaknya memiliki permintaan bantuan kepada saluran yang sesuai.

Sasaran Minggu: Untuk mendapatkan garis besar tentang segmen penginstalan dan detail yang diperlukan terkait cara memperbaiki masalah penginstalan umum.

*** Minggu 2 (9/21-25): Mendokumentasikan Instalasi WINE

Selama Minggu ke-2 saya benar-benar akan menyusun bagian yang menggambarkan instalasi WINE melalui metode populer, termasuk:

Dari sumber yang menggunakan sistem porta;
Melalui paket biner menggunakan repositori inti;
Menggunakan pengelola paket GUI yang tersedia jika tersedia, dan;
Dari repositori alternatif seperti FreshPorts (dan alasan pengguna melakukannya).

Penting untuk bagian ini adalah diskusi tentang penginstalan 32 vs. 64-bit dan simultan, untuk menyoroti langkah-langkah tambahan dalam menjalankan program dari arsitektur yang berbeda.

Sasaran Minggu: Versi draf yang telah disempurnakan dari bagian yang menjelaskan penginstalan WINE di FreeBSD. ""Draf yang disempurnakan"" ini harus menyertakan teks yang sudah hampir final (menunggu pemeriksaan tata bahasa dan masukan peninjauan), serta placeholder untuk screenshot, jika bukan screenshot itu sendiri.

*** Minggu ke-3 (28/9-10/2): Menjalankan Program WINE Pertama Anda di FreeBSD

Setelah subsistem WINE terinstal, bagian berikutnya akan menjelaskan penginstalan dan eksekusi beberapa program awal. Hal ini kemungkinan besar akan berfokus pada utilitas mandiri yang sederhana, seperti Notepad++ open source. Tujuannya adalah agar pengguna dapat mendownload aplikasi dengan cepat, menginstalnya, dan melihatnya berfungsi dengan mudah.

Bagian ini penting untuk menunjukkan kepada pengguna bahwa beberapa/banyak aplikasi Windows yang benar-benar dapat berjalan di FreeBSD, menjadikannya pilihan yang tepat untuk komputasi sehari-hari.

Sasaran Minggu: Identifikasi sejumlah kecil program yang diinstal dengan rapi dan (sebagian besar) langsung berfungsi, serta versi draf yang disempurnakan dari bagian yang menggambarkan penginstalannya.

*** Minggu ke-4 (10/5-9): WINE Overview & Concepts

Bagian akhir dari bagian sebelumnya akan menunjukkan perlunya melakukan beberapa penyesuaian dan penyesuaian agar aplikasi tertentu dapat berfungsi di WINE. Dalam fase ini, pengantar subsistem WINE akan berguna untuk memberikan konteks. Bagian ini akan memeriksa apa yang disertakan dengan sistem WINE, bagaimana ia berinteraksi dengan FreeBSD, dan di mana pengguna bisa mulai mencari untuk lebih memahami sistem atau memecahkan masalah.

Perlu diperhatikan bahwa bagian ini tidak akan menduplikasi sumber daya yang ada, melainkan menyajikan ringkasan terorganisir yang tertaut ke sumber lain (mudah dipahami) untuk informasi lebih lanjut.

Sasaran Minggu: Draf yang telah disempurnakan dari bagian yang memperkenalkan subsistem WINE kepada pengguna.

*** Minggu ke-5 (10/12-16): Konfigurasi WINE pada FreeBSD

Bagian ini akan membahas lebih jauh mengenai konfigurasi WINE yang sebenarnya, dimulai dengan modifikasi/penyelesaian keseluruhan yang khusus untuk FreeBSD. Contoh ini juga akan menggambarkan penggunaan folder $WINEPREFIX, yang dapat digunakan untuk menyesuaikan lingkungan WINE untuk aplikasi tertentu. Karena ada sumber daya yang menjelaskan konsep ini secara mendalam, bagian ini hanya akan memberikan pengantar yang cukup terperinci sebelum menautkannya.

Sasaran Minggu: Draf bagian yang telah disempurnakan yang menguraikan di mana, bagaimana, dan dalam keadaan apa konfigurasi WINE yang mendalam diperlukan.

*** Minggu ke-6 (19-10-23): WINE GUIs di FreeBSD

Jika menyiapkan WINE untuk menjalankan program tertentu dapat menjadi latihan yang kompleks dan memakan waktu, tersedia alat pendukung untuk mempermudah proses ini. Bagian ini akan memberikan ringkasan penginstalan dan penggunaan beberapa opsi yang ada di FreeBSD, termasuk:

WinECfg
Winetricks
Playonbsd
lainnya tersedia

Sasaran Minggu: Untuk memberikan bagian draf yang disempurnakan dengan petunjuk tentang cara menginstal dan menggunakan sebanyak mungkin aplikasi helper GUI WINE terpopuler.

*** Minggu ke-7 (26-10-30): FAQ WINE/FreeBSD (Riset)

Beberapa informasi paling berharga terkait aplikasi teknis yang kompleks seperti WINE dapat ditemukan dalam interaksi antara pengguna yang mencoba memecahkan masalah tertentu dan pakar yang memberikan jawaban. Hal ini akan menghemat banyak waktu pengguna jika beberapa FAQ ini, khususnya yang diketahui memengaruhi pengguna FreeBSD, dikumpulkan di satu tempat.

Bagian ini bertujuan untuk menjawab hal tersebut, dan minggu ini saya akan meneliti jenis masalah yang umumnya dialami pengguna FreeBSD pada WINE, serta memburu dan (sejauh mungkin) menguji jawabannya. Dengan demikian, pembaca bab Buku Panduan ini akan memiliki peluang yang jauh lebih baik untuk menyelesaikan masalah tertentu dengan cepat.

Bagian ini juga akan menyertakan daftar referensi tentang tempat mencari jawaban yang tidak diberikan.

Sasaran Minggu: Draf yang telah diperbarui yang berisi masalah WINE paling umum, baik yang dialami pengguna FreeBSD maupun secara umum, dan link/catatan terkait dengan solusi mereka. Perhatikan bahwa meskipun tugas minggu ini tidak memiliki output draf, kemungkinan akan memerlukan investasi waktu yang lebih besar untuk menemukan dan menyelesaikan masalah umum serta melacak solusinya. Saya memperkirakan akan menghabiskan sekitar 8-10 jam untuk penelitian ini.

*** Minggu ke-8 (11/2-6): FAQ WINE/FreeBSD

Minggu ini akan dihabiskan untuk menyintesis penelitian Minggu ke-7 untuk membuat bagian tentang FAQ/masalah pemecahan masalah umum (menautkan ke solusi yang sesuai).

Sasaran Minggu: Draf yang telah disempurnakan dari bagian yang mencantumkan pertanyaan umum(FAQ)/masalah umum, dan petunjuk langkah demi langkah untuk mengatasinya.

*** Minggu ke-9 (11/9-13): Administrasi WINE multi-pengguna

Bagian ini akan memberikan panduan bagi administrator yang ingin menerapkan WINE dalam skenario multi-pengguna. Hal ini tidak hanya mencakup praktik terbaik untuk membagikan subsistem itu sendiri ke beberapa pengguna, tetapi juga berkaitan dengan aplikasi Windows yang di-deploy dalam WINE.

Sasaran Minggu: Draf yang telah disempurnakan yang merinci panduan dan praktik terbaik bagi administrator FreeBSD untuk men-deploy aplikasi berbasis WINE dan WINE ke beberapa pengguna.

*** Minggu ke-10 (16/11-20): Lampiran, Masukan Ulasan & Administrasi

Meskipun saya akan berusaha untuk menerapkan masukan apa pun yang diterima dari mentor dan peninjau lainnya selama proses penyusunan, minggu ini akan memberikan waktu untuk pengaturan ulang/penulisan ulang yang lebih ekstensif jika diperlukan.

Selain itu, saya akan menulis administrivia apa pun yang diperlukan untuk bab Buku Pegangan ini (materi depan, indeks, dll.) selama waktu ini, serta menyusun bacaan lebih lanjut terkait WINE (misalnya menggunakan versi Linux WINE melalui kompatibilitas biner, DOSBox untuk game/program lama, dll.).

Sasaran Minggu: Draf yang telah disempurnakan dari seluruh bab Buku Panduan, termasuk semua bagian lainnya.

*** Minggu ke-11 (23-11-27): Finalisasi Bab Buku Pegangan

Saya berencana mendedikasikan minggu kedua hingga minggu lalu untuk memeriksa tata bahasa semua teks, memeriksa gambar, dan menguji berbagai {i>output<i} (HTML, PDF, dll.) sesuai kebutuhan. Minggu ini juga akan memungkinkan update jika software di atas (dari FreeBSD itu sendiri hingga WINE atau aplikasi pendukungnya) diupgrade pada saat penulisan awal.

Sasaran Minggu: Versi akhir bab Buku Pegangan, termasuk semua pembaruan yang diperlukan.

*** Minggu ke-12 (30/11-12/5): Finalisasi Proyek

Berdasarkan kesepakatan dengan mentor proyek, saya akan memeriksa bab Buku Pegangan ke dalam {i>source control<i}, menyusun laporan proyek, dan menyerahkan proyek sebagai selesai.