Bu sayfada, Google Dokümanlar Sezonu için kabul edilen bir teknik yazım projesinin ayrıntıları yer almaktadır.
Proje özeti
- Açık kaynak kuruluşu:
- The FreeBSD Project
- Teknik yazar:
- quaffeine
- Proje adı:
- Bir Wine el kitabı bölümü oluşturun
- Proje uzunluğu:
- Standart uzunluk (3 ay)
Proje açıklaması
Bu girişim kapsamında FreeBSD El Kitabı'nın FreeBSD'de WINE'ın (www.winehq.org) kurulumu, kullanımı ve sorun gidermesine ilişkin ayrıntılı, kılavuz uzunluğunda bir bölüm hazırlayacağım. Aksi belirtilmediği sürece her hafta aşağıdaki öğelerle ilgili olarak 4-8 saat çalışmayı hedefliyorum.
*** Topluluk Bağları
Seçilirsem topluluk bağları oluşturma döneminde FreeBSD projesinin doküman süreçleri ve altyapısıyla tanışacağım. Projenin sunduğu tutarlı belgeler beni her zaman etkiledi. Projedeki ekip üyeleriyle iş akışları hakkında iletişime geçerim. Ayrıca, FreeBSD kullanıcılarına genel olarak dokümanlar ve özellikle FreeBSD'te WINE ile çalışma konusunda nelerin yardımcı olacağını anlamak için kullanıcı odaklı forumlara katılır ve bu forumlara göz atarım.
Bu süre zarfında projenin doküman araç zincirini öğrenmek için biraz zaman ayırın. Bu sayede, seçilirsem projenin ilk haftalarında hemen işe koyulabilirim.
*** 1. Hafta (14-19 Eylül): Test Yüklemeleri ve Sorun Giderme
Doküman Geliştirme aşamasının ilk haftasını, FreeBSD'in mevcut kararlı sürümünde WINE'i kurup çalıştırmanın yanı sıra basit yardımcı programlardan daha karmaşık uygulamalara kadar çeşitli Windows uygulamalarını kurup çalıştırarak geçirirdim. Bu, MakeUseOf için ReactOS hakkında yazdığım benzer bir makalede (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/) benimsediğim bir yaklaşımdır. Yalnızca ilk haftayı daha geniş bir program yelpazesini incelemek için kullanırdım.
Deneyimlerime göre bu tür bir zamanı önceden geçirmek, genel sorunları tespit etmek (ve sorun gidermek) için faydalı oluyor. Bu sayede, ilgili bölümleri yazma zamanı geldiğinde çözümleri hazır olur veya en azından yardım isteklerini uygun kanallara iletebilirim.
Hafta Hedefi: Yükleme bölümlerinin ve sık karşılaşılan yükleme sorunlarının nasıl düzeltileceğine ilişkin gerekli ayrıntıların bir özetini oluşturmak.
*** 2. Hafta (21-25 Eylül): WINE Kurulumunu Belgeleme
2. haftada, WINE'ın popüler yöntemlerle kurulumunu gösteren bölümleri taslak haline getiriyorum. Örneğin:
- Bağlantı noktası sistemini kullanarak kaynaktan;
- Temel depoları kullanan ikili paketler aracılığıyla;
- Varsa mevcut GUI paket yöneticilerini kullanma ve;
- FreshPorts gibi alternatif depolardan (ve kullanıcının bunu neden yapmak istediği)
Bu bölümde, farklı mimarilerdeki programları çalıştırmanın gerektirdiği ek adımları vurgulamak için 32 bit ve 64 bit arasındaki farklar ve eşzamanlı yüklemeler ele alınmaktadır.
Haftanın Hedefi: FreeBSD'e WINE'in kurulumunu açıklayan bölümlerin düzeltilmiş bir taslak sürümü. Bu ""ciltlenmiş taslak"", neredeyse son metin (gözden geçirme ve inceleme geri bildirimi bekleniyor) ve ekran görüntüleri değilse ekran görüntüleri için yer tutucular içermelidir.
*** 3. Hafta (28 Eylül-2 Ekim): FreeBSD'de İlk WINE Programınızı Çalıştırma
WINE alt sistemi yüklendikten sonraki bölümde bazı başlangıç programlarının yüklenmesi ve yürütülmesi ayrıntılı olarak ele alınacaktır. Bunlar büyük olasılıkla, açık kaynak Notepad++ gibi basit, bağımsız yardımcı programlara odaklanır. Amaç, kullanıcıların bir uygulamayı hızlı bir şekilde indirmesini, yüklemesini ve en az düzeyde sorunsuz bir şekilde çalıştığını görmesini sağlamaktır.
Bu bölüm, kullanıcılara bazı/birçok Windows uygulamasının FreeBSD'te çalışabileceğini ve bu nedenle FreeBSD'in günlük bilgisayar kullanımı için uygun bir seçenek olduğunu göstermek açısından önemlidir.
Haftanın Hedefi: Kolayca yüklenen ve (çoğunlukla) kutudan çıkar çıkmaz çalışan az sayıda programın belirlenmesi ve bu programların yüklenmesini gösteren bölümlerin iyileştirilmiş bir taslak sürümü.
*** 4. Hafta (5-9 Ekim): WINE'a Genel Bakış ve Kavramlar
Önceki bölümün sonunda, belirli uygulamaların WINE'da çalışmasını sağlamak için bazı ayarlamalar ve özelleştirmeler yapılması gerektiği belirtilir. Bu noktada, bağlam sağlamak için WINE alt sistemine giriş yapılması yararlı olur. Bu bölümlerde WINE sistemiyle birlikte neler geldiği, FreeBSD ile nasıl etkileşim kurulduğu ve kullanıcının sistemi daha ayrıntılı anlamak veya sorunları gidermek için nerede aramaya başlayabileceği incelenmektedir.
Bu bölümün, mevcut kaynakları kopyalamayı değil, daha fazla bilgi için diğer (kolayca anlaşılır) kaynaklara bağlantılar içeren düzenli bir genel bakış sunmayı amaçladığını belirtmek önemlidir.
Haftanın Hedefi: WINE alt sistemini kullanıcılara tanıtan bölümlerin düzeltilmiş taslağı.
*** 5. Hafta (12-16 Ekim): FreeBSD'te WINE Yapılandırması
Bu bölümlerde, FreeBSD'ye özel genel değişiklikler/ayarlamalarla başlayarak gerçek WINE yapılandırması daha ayrıntılı bir şekilde ele alınacaktır. Ayrıca, WINE ortamını belirli bir uygulama için özelleştirmek üzere kullanılabilen $WINEPREFIX klasörlerinin kullanımını da gösterirler. Bu kavramı ayrıntılı olarak açıklayan mevcut kaynaklar olduğundan bu bölümde, bu kaynaklara bağlantı vermeden önce yalnızca orta düzeyde ayrıntılı bir giriş sağlanır.
Haftanın Hedefleri: Ayrıntılı WINE yapılandırmasının nerede, nasıl ve hangi koşullarda gerekli olduğunu ayrıntılı olarak açıklayan bölümlerin düzeltilmiş taslağı.
*** 6. Hafta (19-23 Ekim): FreeBSD'te WINE GUI'leri
Belirli bir programı yürütmek için WINE'ı ayarlamanın karmaşık ve zaman alıcı bir çalışma olduğu düşünüldüğünde, bu süreci kolaylaştıracak yardımcı araçlar mevcuttur. Bu bölümlerde, FreeBSD'te bulunan seçeneklerden bazılarının yükleme ve kullanım özelliklerine genel bir bakış sunulur. Örneğin:
- WINECfg
- winetricks
- playonbsd
- uygun olarak diğerleri
Haftanın Hedefi: En popüler GUI WINE yardımcı uygulamalarının çoğunun yüklenmesi ve kullanılmasıyla ilgili talimatların yer aldığı, özenle hazırlanmış taslak bölümler sunmak.
*** 7. Hafta (26-30 Ekim): WINE/FreeBSD SSS (Araştırma)
WINE gibi karmaşık teknik uygulamalarla ilgili en değerli bilgilerden bazıları, belirli sorunları çözmeye çalışan kullanıcılar ile yanıt veren uzmanlar arasındaki etkileşimde bulunabilir. Bu SSS'lerden bazılarının, özellikle de FreeBSD kullanıcılarını etkilediği bilinenlerin tek bir yerde toplanması kullanıcılara önemli ölçüde zaman kazandıracaktır.
Bu bölümlerin amacı tam da budur. Bu haftayı, FreeBSD kullanıcılarının WINE ile ilgili sık karşılaştıkları sorun türlerini araştırmak ve mümkün olduğunca yanıtlarını bulmak ve test etmek için harcayacağım. Bu sayede, bu kılavuz bölümünün okuyucuları belirli bir sorunu daha hızlı çözme şansına sahip olur.
Bu bölümlerde, sağlanmayan yanıtların nerede aranacağına dair kaynakların listesi de yer alır.
Haftanın Hedefi: FreeBSD kullanıcıları tarafından veya genel olarak karşılaşılan en yaygın WINE sorunlarını ve çözümleriyle ilgili bağlantıları/notları içeren, iyileştirilmiş taslak bölümler. Bu haftaki çalışmada taslak çıktı bulunmasa da yaygın sorunları bulup uzlaştırmanın ve çözümlerini bulmanın muhtemelen daha fazla zaman alacağını unutmayın. Bu araştırma için 8-10 saat harcayacağımı düşünüyorum.
*** 8. Hafta (2-6 Kasım): WINE/FreeBSD Hakkında SSS
Bu hafta, SSS/sık karşılaşılan sorun giderme sorunları ile ilgili bölümleri oluşturmak için 7. Hafta'daki araştırmayı sentezlemek için kullanılır (uygun olduğunda çözümlere bağlantı verilir).
Hafta Hedefi: Sık sorulan soruların/sık karşılaşılan sorunların ve bunları çözmeye yönelik adım adım talimatların listelendiği bölümlerin özenli bir taslağı.
*** 9. Hafta (9-13 Kasım): Çok kullanıcılı WINE yönetimi
Bu bölümler, WINE'i çok kullanıcılı bir senaryoda dağıtmak isteyen yöneticilere yol gösterir. Bu, yalnızca alt sistemin kendisini birden fazla kullanıcı arasında paylaşmayla ilgili en iyi uygulamaları değil, aynı zamanda WINE'da dağıtılan Windows uygulamalarıyla ilgili en iyi uygulamaları da içerir.
Haftanın Hedefi: FreeBSD yöneticilerinin WINE ve WINE tabanlı uygulamaları birden fazla kullanıcıya dağıtması için yol gösterici bilgiler ve en iyi uygulamaları içeren, iyileştirilmiş taslak bölümler.
*** 10. Hafta (16-20 Kasım): Ekler, Yorumları İnceleme ve Yönetimsel İşlemler
Taslak oluşturma sürecinde mentorlardan ve diğer incelemecilerden aldığımız geri bildirimleri uygulamaya çalışacağız. Ancak gerekirse bu hafta daha kapsamlı bir yeniden düzenleme/yeniden yazma işlemi için zaman ayıracağız.
Ayrıca bu süre zarfında bu El Kitabı bölümü için gerekli olan tüm idari bilgileri (önceki konular, dizinler vb.) yazar ve WINE ile ilgili daha fazla okuma (ör. ikili uyumluluk üzerinden WINE'in Linux sürümünü kullanma, eski oyunlar/programlar için DOSBox vb.) derleyeceğim.
Haftanın Hedefi: Diğer tüm bölümler dahil olmak üzere El Kitabı bölümünün tamamının düzeltilmiş taslağı.
*** 11. Hafta (23.11-27): El Kitabı Bölüm Sonlandırması
Bu sondan ikinci haftayı tüm metinlerin gözden geçirilmesi, görsellerin kontrol edilmesi ve gerektiğinde çeşitli çıkışların (HTML, PDF vb.) test edilmesi için ayırmayı planlıyorum. Bu hafta, yukarıdaki yazılımlardan herhangi birinin (FreeBSD'den WINE'e veya yardımcılarına kadar) ilk yazıldığı tarihten bu yana yükseltilmesi durumunda güncellemelere de izin verilecektir.
Haftanın Hedefi: Gerekli tüm güncellemeler dahil olmak üzere El Kitabı bölümünün son sürümü.
*** 12. Hafta (30.11-5.12): Projenin Tamamlanması
Proje mentorlarıyla anlaştıktan sonra El Kitabı bölümünü kaynak kontrolü olarak kontrol eder, proje raporunu hazırlar ve projeyi tamamlanmış olarak gönderirdim.