Bu sayfada, Google Season of Docs için kabul edilen bir teknik doküman yazma projesinin ayrıntıları yer almaktadır.
Proje özeti
- Açık kaynak kuruluşu:
- Qubes OS
- Teknik yazar:
- luzeal
- Proje adı:
- QubesOS ile ilk katılım Açık ve kolay anlaşılır bir rehber yazalım
- Proje uzunluğu:
- Standart süre (3 ay)
Proje açıklaması
QubesOS ile ilk katılım
İlk kez QubesOS kullananlar için açık bir kılavuz ve ilgili materyaller oluşturmak istiyorum. Hedef, QubesOS'u sıradan kullanıcılara tanıtmak ve kılavuzu mümkün olduğunca kısa ve anlaşılır tutmaktır. Bunun için analojiler, resimler ve diyagramlar kullanılacaktır. Kısa ve öz olması için öncelikle QubesOS web sitesinde bulunanlar olmak üzere güvenilir kaynaklara bağlantılar verilecektir. Her şey açık lisansla yayınlanır.
Bağımsız içerik derken, web sitesinden bağımsız olarak var olabilecek içerikleri (ör. el kitabı) kastediyorum. Bu sürüm, rehberin çevrimdışı sürümüyle aynı değildir. İdeal olarak, içeriği rehber olarak yayınlamak için web sitesinin yanı sıra başka bir ardışık düzen oluşturulur.
Açık kaynaklı lisansla yayınlanacak bir rehberden bahsediyorum.
Nasıl yapılabilir?
Hedef kitleyi tanımlama
Bugün itibarıyla, QubesOS'un hedeflediği kullanıcı kategorisinin iyi tanımlanmadığı izlenimine sahibim. QubesOS; gazetecilere, avukatlara, güvenlik analistlerine, yazılım geliştiricilere ve diğer kullanıcılara nasıl yardımcı olabilir? QubeOS'un faydalı olabileceği senaryoları açıklamak aydınlatıcı olacaktır.
Beklentileri doğru şekilde belirleyin
Ayrıca, ilk kez kullananları QubesOS'un belirli bir düzeyde BT bilgisi gerektirdiği konusunda uyarmak da önemlidir. QubesOS'i kullanmanın, özellikle birincil bilgi işlem sisteminiz QubesOS ise kullanılabilirlik açısından bir bedeli vardır. Aynı şekilde, QubeOS'un (tasarım gereği) iyi yapamayacağı şeyler de vardır. Örneğin, sanal makinelerde 3D hızlandırma. Bu özelliği kullanacak kişileri caydırmak için değil, potansiyel kullanıcıların beklentilerini belirlemek için en başından itibaren net bir şekilde belirtmek önemlidir.
QubesOS nedir ve QubesOS ne değildir?
QubesOS özel bir işletim sistemi türü (Xen dağıtımı) olsa da işlevlerine veya işlev eksikliklerine göre diğer işletim sistemleriyle karşılaştırmak ilginç olabilir (örneğin, Windows güvenlik mekanizması olarak sanallaştırma ve korumalı alan kullanımını giderek artırıyor). Basit bir diyagram/tablo kullanılabilir.
Rehberin özellikleri toplulukla birlikte belirlenir.
Rehberde bulunması gereken minimum bilgiler nelerdir? Güvenlikten ödün vermeden kurulum ne kadar basitleştirilebilir? Eşik nerede olmalı? Minimum uygulanabilir ve güvenli bir QubesOS kurulumu var mı? Hayırsa tanımlanabilir ve kılavuzun hedefi olarak ayarlanabilir.
Lisans
Lisans alma Saygın bir kaynak olan Archlinux wiki, GNU Free Documentation License 1.3 veya sonraki sürümlerini kullanır. Bu lisans uygun olur mu?
Diğer girişimler
Web sitesi belgelerini daha ilgi çekici hale getirme
Notlar, daha kolay fark edilebilmeleri için kırmızı veya sarı renkle vurgulanabilir. Örneğin, archlinux wiki'de bulunanlar gibi renk kutuları kullanılabilir. https://wiki.archlinux.org/index.php/Linux_Containers.
Alıntı blokları kullanılabilir.
Bağlantı içerikleri
Belgeleme web sitesinde şu anda oldukça fazla içerik var ancak bu içerikler genellikle diğer alakalı konulara bağlanmıyor. Keşfedilebilirliği artırmak için makaleler birbirine bağlanabilir.