Ta strona zawiera szczegółowe informacje na temat projektu technicznego przyjęta do programu Sezon Dokumentów Google.
Podsumowanie projektu
- Organizacja open source:
- Qubes OS
- Pisarz techniczny:
- luzeal
- Nazwa projektu:
- Zacznij korzystać z QubesOS Napiszmy otwarty i łatwy w obsłudze przewodnik
- Długość projektu:
- Standardowa długość (3 miesiące)
Opis projektu
Rejestracja w QubesOS
Chcę utworzyć otwarty przewodnik i powiązane materiały dla początkujących użytkowników QubesOS. Celem jest zaprezentowanie QubesOS laikom z wykorzystaniem analogii, ilustracji i schematów oraz zadbanie o to, aby przewodnik był jak najbardziej zwięzły i zrozumiały. Aby zachować zwięzłość, wykorzystamy linki do niezawodnych i zaufanych zasobów, w tym przede wszystkim tych dostępnych na stronie QubesOS. Wszystko zostanie opublikowane na licencji otwartej.
Samodzielna treść ma na myśli treść, która może istnieć niezależnie od witryny, na przykład jako podręcznik. Nie ma to związku z wersją przewodnika offline. W idealnej sytuacji, wraz z witryną, zostanie utworzony kolejny potok publikacji treści jako przewodnika.
„Otwarty” oznacza przewodnik, który zostanie udostępniony na licencji otwartej.
Jak to się odbywa
Określanie docelowych odbiorców
Obecnie mam wrażenie, że kategoria użytkowników, na którą kieruje reklamy QubesOS, nie jest dobrze zdefiniowana. W jaki sposób QubesOS może pomóc dziennikarzom, prawnikom, analitykom zabezpieczeń, programistom oprogramowania i innym osobom? Chętnie opowiem o scenariuszach, w których QubeOS może okazać się przydatny.
Określ właściwe oczekiwania
Trzeba też ostrzegać nowych użytkowników, że QubesOS wymaga pewnej wiedzy z zakresu IT. Korzystanie z QubesOS jest płatne pod względem łatwości obsługi, zwłaszcza jeśli QubesOS jest Twoim podstawowym systemem obliczeniowym. Z tego samego tokenu korzysta się wolniej (z założenia projektu QubeOS), na przykład przyspieszanie 3D w maszynach wirtualnych. Ważne jest, aby był on zrozumiały od samego początku – nie zniechęcaj użytkowników do korzystania z niego, ale wprowadzaj w życie pewne wyjątki dla potencjalnych użytkowników.
Czym jest QubesOS, a czego nie
Mimo że QubesOS jest specjalną rasą systemu operacyjnego (dystrybucją Xen), być może warto porównać go z innymi systemami operacyjnymi na podstawie ich funkcji lub ich braku (np. Windows coraz częściej używa wirtualizacji i piaskownicy jako mechanizmów zabezpieczających). Można użyć prostego diagramu/tabeli.
Specyfikacje materiałów muszą zostać opracowane ze społecznością użytkowników.
Jakie informacje powinien zawierać przewodnik? W jakim stopniu można uprościć instalację, nie rezygnując z bezpieczeństwa? Gdzie powinien znajdować się próg? Czy istnieje coś takiego jak minimalnie możliwa i bezpieczna konfiguracja QubesOS? Jeśli nie, można ją zdefiniować i ustawić jako cel przewodnika.
Licencja
Odbierz licencję. Dobrze renomowana witryna wiki Archlinux korzysta z licencji GNU Free Dokumentacja License w wersji 1.3 lub nowszej. Czy ta licencja byłaby odpowiednia?
Inne przedsięwzięcia
Zadbaj o to, aby dokumentacja witryny była bardziej atrakcyjna wizualnie.
Notatki można wyróżnić za pomocą czerwonego lub żółtego koloru, aby zwiększyć ich widoczność. Można na przykład użyć kolorowych pól, takich jak te na stronie wiki archlinux https://wiki.archlinux.org/index.php/Linux_Containers.
Można użyć cytatów blokowych.
Treść linku
Witryna z dokumentacją zawiera obecnie sporo treści, ale poszczególne artykuły często nie są powiązane z innymi istotnymi tematami. Artykuły można łączyć ze sobą, aby zwiększyć wykrywalność.