Qubes OS projesi

Bu sayfa, Google Dokümanlar Sezonu için kabul edilen bir teknik yazı projesinin ayrıntılarını içerir.

Proje özeti

Açık kaynak kuruluşu:
Qubes İşletim Sistemi
Teknik yazar:
c1e0
Projenin adı:
Sorun giderme kılavuzlarını birleştirin
Proje süresi:
Standart uzunluk (3 ay)

Proje açıklaması

ÖZET

Sorun giderme kılavuzu, son kullanıcıların bir ürün veya hizmeti kullanırken karşılaştıkları sorunları çözmesine yardımcı olmak üzere tasarlanmıştır. İyi bir sorun giderme kılavuzu, bir sorun ortaya çıktığında kullanıcılara yardımcı olduğu için önemlidir. Sorunla karşılaştıklarında kullanıcıların üründen vazgeçmelerini sağlar. Qubes'ın dünya çapında günlük binlerce kullanıcısı vardır. Bu kullanıcıların çoğu belli bir zamanda sorunla karşılaşacak ve sorun giderme kılavuzundan faydalanacaktır.

SORUN GİDERME KILAVUZUNUN MEVCUT DURUMU

Şu anda QubesOS sorun giderme kılavuzları birçok sayfaya dağılmış durumda ve bazen eksik olduğundan, kullanıcıların sorunları teşhis etmesine yardımcı olurken aynı talimatları tekrar tekrar yayınlamalarına neden olabiliyor. Mevcut kılavuzlarda, belirti eylemi düzenine yer verilmemektedir. Bu durum, kullanıcının bir sorunu çözümüyle eşleştirmesini zorlaştırmaktadır. Ayrıca sosyal medyada (Reddit), Qubes GitHub sorunları sayfasında ve #qubes-users forumunda tekrar tekrar dile getirilen, ancak güncel sorun giderme kılavuzunda yer almayan bazı sorunlar da bulunmaktadır.

ÖNERİLEN SORUN GİDERME KILAVUZU NEDEN MEVCUT KULLANICIYA GÖRE İYİLEŞTİRMEMİZ?

Size önerdiğim sorun giderme kılavuzu eksiksiz ve yapılandırılmış olup doğru ve kolay gezinilebilir olmalıdır. Kılavuz, bir sorunun nasıl çözüleceğini adım adım açıklayan kısa talimatlar gösterecektir. Bu düzende, bir sorun belirtilmeden önce bir işlem düzeni bulunur. Bu düzende bir sorun belirtilir ve ardından bu sorunu çözmek için bir çözüm önerilir. Sorun giderme işlemleri, kullanıcıların sosyal medyada ve arama motorlarında arama yaparken hangi sorunları incelediği dikkate alınarak arama motoru için optimize edilir ve ifade edilir. Tüm bunlar, kullanıcıların arama motorlarında resmi sorun giderme kılavuzunu bulabilmelerini ve sorunlarına hızlı/kolay bir şekilde çözüm bulmalarını sağlamak için yerine getirilecektir.

ÖNERİLEN SORUN GİDERME KILAVUZUNUN ve ZAMAN DÖNEMİ'NİN YAPISI

Qubes OS sorun giderme kılavuzu için önerilen bir yapı oluşturdum. Yapıyı şu adreste bulabilirsiniz: https://docs.google.com/document/d/187NlnEvctYVVUnRuGtwY2PkYBVxBSSPfpSwZEaczqL8/edit?usp=sharing. Düzende, her sorun giderme bölümünün yazılacağı tahmini bir zaman aralığı bulunur. Bu düzen, mentorun geri bildiriminden sonra uygulanır. Yapı ve zaman aralığı, mentorun geri bildirimine göre değiştirilebilir.

PROJE HEDEFLERİ

  • Sorun giderme kılavuzunu, daha anlaşılır ve birleştirilmiş belirti eylemi düzenine sahip olacak şekilde yeniden yapılandırın.
  • Mevcut sorun giderme sorunlarını uygulaması kolay adım adım talimatlara sahip olacak şekilde yeniden yazın.
  • Gerekirse ekran görüntüsü ekleyin
  • Qubes'ı kendim yükleyip deneyin ve karşılaşılan sorunları kaydedin. Üç bilgisayarım var: Lenovo Thinkpad, Dell Latitude ve Acer Aspire. Qubes'ı bu bilgisayarların her birinde deneyerek hataları kaydedeceğim ve sorun giderme adımlarını göstereceğim.
  • Mevcut kılavuzdaki eski bilgileri kaldırın.
  • Sorun giderme işlemlerinin doğru olduğundan emin olun. Şimdilik, mevcut sorun giderme kılavuzlarında ""Bu resmi olmayan, üçüncü taraf bir dokümandır. Qubes OS Projesi bu sayfanın doğruluğunu garanti edemez. Lütfen dikkatli olun"". Sorun giderme talimatlarının doğru olduğu doğrulandıktan sonra bu uyarı silinir. Bu bilgilerin doğruluğu, PC'lerimde sorun giderme sorunlarını bizzat test edilerek (mümkünse) veya çözümün kullanıcılar tarafından doğrulanmış olup olmadığını çevrimiçi kontrol edilerek sağlanır.
  • Harici sorun giderme sorunlarını (forum ve GitHub'dan) resmi sorun giderme web sayfasına taşıyın.
  • Reddit (r/QubesOS), Stack Exchange, #qubes-users Google Grubu ve GitHub'daki kullanıcıların karşılaştığı diğer sorunları araştırın ve bulun. Google gibi arama motorlarında sıkça aranan soruları keşfetmek için Keywordtool.io ve UberSuggest.com gibi anahtar kelime araştırma araçlarını da kullanacağım.
  • Sorun giderme kılavuzu kullanıcıların sorununu çözmezse "Yardım alma" bölümü ekleyin. Bu konuyla ilgili bir örneği Fedora'nın sorun giderme sayfasında görebilirsiniz: https://docs.fedoraproject.org/en-US/fedora/rawhide/install-guide/install/troubleshooting/#sect-troubleshooting-getting-help

NEDEN BU PROJE?

Teknoloji, özellikle de siber güvenlik ve gizlilik konusunda tutkuluyum. Yazmak benim için en güçlü yönlerden biri. Qubes işletim sistemiyle ilgileniyorum çünkü iki temel ilgi alanımla kesişiyor: güvenlik ve gizlilik. DuckDuckGo ve Tor gibi diğer güvenlik ve gizlilik odaklı ürünleri yoğun bir şekilde kullanıyorum. Qubes OS'i yeni keşfettim ve şu ana kadar çok beğendim.

NEDEN BU PROJE İÇİN DOĞRU KİŞİSİM OLDUĞUNU DÜŞÜNÜYORUM

  • Güvenlik, gizlilik ve faydalı/faydalı belgeler yazma konusunda tutkuluyum.
  • Qubes OS'i yüklerken ve kullanırken sorun yaşadığım için bu sorunları sorun giderme talimatlarında daha iyi açıklayabileceğim.
  • Geçen ay Qubes İşletim Sistemi'nin teknik yönleri üzerine çalıştım. Qubes OS belgelerini de kapsamlı şekilde inceledim. Belge düzenleme süreci hakkında fikir edinmek için bir pull isteği oluşturdum (https://github.com/QubesOS/qubes-doc/pull/1005/files)
  • Kısa süre önce Tor projesinde staj yaptım. Görevlerim teknik destek ve yazarlıktı. Yardım masasında çalışırken, Tor Tarayıcı'yı yüklerken veya kullanırken sorun yaşayan kullanıcılardan yüzlerce soru aldım. Bu kullanıcıların sorunlarını gidermesine yardımcı olarak kısa ve anlaşılır sorun giderme talimatlarını nasıl yazacağımı öğrendim.
  • Tor Projesi'nde çalışırken Markdown'ı kullanarak teknik dokümanlar da yazdım. Sürüm kontrolü için Git, GitHub ve GitLab'i kullandım.