Qubes OS projesi

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:
Qubes OS
Teknik yazar:
c1e0
Projenin adı:
Sorun giderme kılavuzlarını birleştirme
Proje uzunluğu:
Standart uzunluk (3 ay)

Proje açıklaması

ABSTRACT

Sorun giderme kılavuzları, son kullanıcıların bir ürün veya hizmeti kullanırken karşılaştıkları sorunları çözmelerine yardımcı olmak için tasarlanmıştır. Sorun oluştuğunda kullanıcılara yardımcı olduğu için iyi bir sorun giderme kılavuzu önemlidir. Bu sayede kullanıcılar, bir sorunla karşılaştıklarında ürünü kullanmayı bırakmaz. Qubes'in dünya genelinde her gün binlerce kullanıcısı var. Bu kullanıcıların çoğu, bir noktada sorunla karşılaşır ve sorun giderme kılavuzundan yararlanır.

SORUN GİDERME KILAVUZUNUN MEVCUT DURUMU

Şu anda QubesOS sorun giderme kılavuzları birçok sayfaya dağılmış durumda ve bazen eksik. Bu da kullanıcıların sorunları teşhis etmesine yardımcı olurken aynı talimatın tekrar tekrar yayınlanmasına neden oluyor. Mevcut kılavuzlarda belirti-işlem düzeni olmadığından kullanıcıların bir sorunu çözümüyle eşleştirmesi zor oluyor. Ayrıca, sosyal medyada (Reddit), Qubes Github sorunları sayfasında ve #qubes-users forumunda defalarca bahsedilen ancak mevcut sorun giderme kılavuzunda yer almayan bazı sorunlar vardır.

ÖNERDİĞİM SORUN GİDERME KILAVUZU, MEVCUT KILAVUZA NEDEN İYİ BİR DEĞİŞİKLİK?

Önerdiğim sorun giderme kılavuzum eksiksiz ve doğru olmasını ve kolayca gezinmeyi sağlayacak şekilde yapılandırılmış olacak. Kılavuzda bir sorunun nasıl çözüleceğini adım adım açıklayan kısa ve öz talimatlar açıklanıyor. Bu sayfada, bir sorunun belirtildiği ve ardından bu sorunu çözmek için önerilen bir çözümün yer aldığı bir belirti-işlem düzeni bulunur. Sorun giderme adımları, arama motorları için optimize edilir ve kullanıcıların sosyal medya ile arama motorlarında aradığı sorunlar göz önünde bulundurularak yazılır. Tüm bunlar, kullanıcıların arama motorları üzerinden resmi sorun giderme kılavuzunu bulmasını ve sorunlarına hızlı/kolay bir şekilde çözüm bulmasını sağlayacaktır.

ÖNERİLECEK SORUN GİDERME KILAVUZU'NUN YAPISI ve ZAMAN ÇERÇEVESİ

Qubes OS sorun giderme kılavuzu için önerilen bir yapıyı oluşturdum. Bu yapıyı şu adreste bulabilirsiniz: https://docs.google.com/document/d/187NlnEvctYVVUnRuGtwY2PkYBVxBSSPfpSwZEaczqL8/edit?reach=sharing. Bu sayfaya, her sorun giderme bölümünün yazılacağı tahmini zaman aralığı da eklenir. Bu düzen, mentordan geri bildirim alındıktan sonra uygulanır. Yapı ve zaman aralığı, mentor geri bildirimlerine göre değiştirilebilir.

PROJE HEDEFLERİ

  • Sorun giderme kılavuzunu daha anlaşılır ve birleştirilmiş bir belirti-işlem düzenine sahip olacak şekilde yeniden yapılandırdık.
  • Mevcut sorun giderme adımlarını, kolayca uygulanabilen adım adım talimatlar içerecek şekilde yeniden yazın.
  • Gerektiğinde ekran görüntüleri ekleyin
  • Qubes'i kendim yükleyip denedim ve karşılaşılan sorunları kaydettim. Üç bilgisayarım var: Lenovo Thinkpad, Dell Latitude ve Acer Aspire. Bu bilgisayarların her birinde Qubes'i deneyeceğim, hataları kaydedecek ve sorun giderme işlemlerini doğrulayacağım.
  • Mevcut kılavuzda güncelliğini yitirmiş bilgileri kaldırın.
  • Sorun giderme işlemlerinin doğru olduğundan emin olun. Mevcut sorun giderme kılavuzlarında şu anda "Bu, resmi olmayan, üçüncü taraf dokümanlarıdır. Qubes OS Project 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ı kaldırılır. Sorun giderme adımlarının doğruluğu, mümkünse PC'lerimde bu adımları kişisel olarak test ederek veya herhangi bir kullanıcının çözümü doğrulayıp doğrulamadığını internette kontrol ederek sağlanır.
  • Harici sorun giderme adımlarını (forumdan ve GitHub'dan) resmi sorun giderme web sayfasına taşıyın.
  • Reddit (r/QubesOS), Stack Exchange, #qubes-users Google grubu ve GitHub sorunlarında kullanıcıların karşılaştığı diğer sorunları araştırın. Google gibi arama motorlarında sık aranan soruları öğrenmek 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. Fedora'nın sorun giderme sayfasında buna örnek verilebilir: https://docs.fedoraproject.org/en-US/fedora/rawhide/install-guide/install/Troubleshooting/#sect-troubleshooting-getting-help.

NEDEN BU PROJE?

Özellikle siber güvenlik ve gizlilik olmak üzere teknoloji konusunda tutkuluyum. Yazmanın en güçlü yanlarımdan biri olduğuna inanıyorum. Özellikle Qubes işletim sistemiyle ilgileniyorum çünkü güvenlik ve gizlilik olmak üzere iki önemli ilgi alanımla kesişiyor. DuckDuckGo ve Tor gibi güvenlik ve gizlilik odaklı diğer ürünlerin sıkı bir kullanıcısıyım. Qubes OS'i kısa süre önce keşfettim ve şimdiye kadar çok beğendim.

NEDEN BU PROJE İÇİN DOĞRU KİŞİ OLMADIM?

  • Güvenlik ve gizlilik konusunda tutkuluyum. İyi/faydalı dokümanlar yazmaktayım.
  • Qubes OS'i yüklerken ve kullanırken sorunlar yaşadığım için bu sorunları sorun giderme talimatlarında daha iyi açıklayabilirim.
  • Geçtiğimiz ay, Qubes işletim sisteminin teknik yönlerini inceledim. Ayrıca Qubes OS dokümanlarını da ayrıntılı bir şekilde inceledim. Doküman düzenleme sürecini anlamak için bir çekme isteği oluşturdum (https://github.com/QubesOS/qubes-doc/pull/1005/files).
  • Kısa süre önce Tor projesinde stajımı tamamladım. Teknik destek ve yazma rollerini üstlendim. Yardım masasında çalışırken Tor Browser'ı yüklerken veya kullanırken sorun yaşayan kullanıcılardan yüzlerce soru aldım. Bu kullanıcılara sorunlarını giderme konusunda yardımcı olarak, kısa ve anlaşılır sorun giderme talimatları yazmayı öğrendim.
  • Tor Project'te çalışırken Markdown'ı kullanarak teknik dokümanlar da yazdım. Sürüm kontrolü için Git, GitHub ve GitLab'ı kullandım.