Projekt Qubes OS

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:
c1e0
Nazwa projektu:
Skonsoliduj przewodniki rozwiązywania problemów
Długość projektu:
Standardowa długość (3 miesiące)

Opis projektu

Streszczenie

Przewodnik dotyczący rozwiązywania problemów ma pomóc użytkownikom w rozwiązywaniu problemów występujących podczas korzystania z produktów lub usług. Dobry przewodnik dotyczący rozwiązywania problemów jest ważny, ponieważ pomaga użytkownikom, gdy pojawią się problemy. Dzięki niej użytkownicy nie porzucą produktu, gdy napotkają problem. Każdego dnia Qubes korzysta z tysięcy użytkowników na całym świecie. Wielu z nich w pewnym momencie napotka problem i skorzysta z poradnika, jak je rozwiązać.

OBECNY STAN PRZEWODNIKA ROZWIĄZYWANIA PROBLEMÓW

Przewodniki dotyczące rozwiązywania problemów z QubesOS są obecnie rozrzucone na wielu stronach i czasami są niepełne, co powoduje wielokrotne publikowanie tych samych instrukcji podczas pomagania użytkownikom w diagnozowaniu problemów. W dostępnych przewodnikach brakuje układu objawów, co utrudnia użytkownikowi dopasowanie rozwiązania problemu. Oprócz tego niektóre problemy są wielokrotnie wspominane w mediach społecznościowych (Reddit), na stronie z problemami Qubes w GitHubie i na #qubes-users, ale nie ma ich w obecnym przewodniku dotyczącym rozwiązywania problemów.

DLACZEGO PROPONOWANY PRZEWODNIK PO ROZWIĄZANIU PROBLEMÓW JEST Udoskonalony w porównaniu z OBECNYM?

Proponowany przeze mnie przewodnik dotyczący rozwiązywania problemów będzie kompletny i uporządkowany, zapewniając dokładność i łatwą nawigację. Przewodnik zawiera zwięzłe instrukcje, które krok po kroku wyjaśnią, jak rozwiązać problem. Będzie on zawierał układ objawów, w którym opisany zostanie problem oraz rekomendowane rozwiązanie problemu. Rozwiązania te są optymalizowane pod kątem wyszukiwarek i formułowane tak, aby uwzględniały problemy wyszukiwane przez użytkowników w mediach społecznościowych i wyszukiwarkach. Dzięki temu użytkownicy będą mogli znaleźć oficjalny przewodnik rozwiązywania problemów w wyszukiwarkach oraz szybko i łatwo znaleźć rozwiązanie swojego problemu.

STRUKTURA PROPONOWANYCH PRZEWODNIKÓW ROZWIĄZYWANIA PROBLEMÓW I OKRESY CZASOWE

Przygotowałem propozycję struktury przewodnika dotyczącego rozwiązywania problemów z systemem Qubes, którą można znaleźć tutaj: https://docs.google.com/document/d/187NlnEvctYVVUnRuGtwY2PkYBVxBSSPfpSwZEaczqL8/edit?usp=sharing. Do układu graficznego towarzyszy szacowany czas, w którym należy napisać każdą sekcję dotyczącą rozwiązywania problemów. Ten układ zostanie wdrożony po wskazaniu opinii mentora. Struktura i przedział czasowy mogą ulec zmianie na podstawie opinii mentora.

CELE PROJEKTU

  • Zmień strukturę przewodnika dotyczącego rozwiązywania problemów, aby był bardziej zrozumiały i skonsolidowany.
  • Przeredaguj dotychczasowe sposoby rozwiązania problemu, aby uzyskać proste, szczegółowe instrukcje.
  • W razie potrzeby dodaj zrzuty ekranu
  • Zainstaluj i wypróbuj Qubes samodzielnie oraz rejestruj wszelkie napotkane problemy. Mam 3 komputery: Lenovo Thinkpad, Dell Latitude i Acer Aspire. Wypróbuję Qubes na każdym z tych komputerów, rejestrując wszystkie błędy i weryfikowając ewentualne rozwiązania.
  • Usuń z istniejącego przewodnika wszelkie przestarzałe informacje.
  • Zadbaj o to, aby rozwiązywać problemy prawidłowo. Obecnie w przewodnikach dotyczących rozwiązywania problemów pojawia się komunikat o błędzie „To nieoficjalna dokumentacja zewnętrzna. Projekt Qubes OS nie gwarantuje dokładności tej strony. Zachowaj ostrożność”." To ostrzeżenie zostanie odrzucone, gdy sprawdzimy, czy instrukcje rozwiązywania problemów są poprawne. Zapewni to ich dokładność przez osobiste przetestowanie rozwiązań na moim komputerze (jeśli to możliwe) lub sprawdzenie online, czy ktoś zweryfikował rozwiązanie.
  • Przenieś wszelkie zewnętrzne rozwiązania do rozwiązywania problemów (z forum i GitHuba) na oficjalną stronę rozwiązywania problemów.
  • Zbadaj więcej problemów, których doświadczają użytkownicy z takich problemów jak Reddit (r/QubesOS), Stack Exchange, #qubes-users, grupa dyskusyjna Google i GitHub. Będę też korzystać z narzędzi do analizy słów kluczowych, takich jak Keywordtool.io i UberSuggest.com, aby sprawdzać, jakie pytania są często wyszukiwane w wyszukiwarkach, takich jak Google.
  • Dodaj sekcję „Uzyskiwanie pomocy” na wypadek, gdyby przewodnik użytkownika nie pomógł w rozwiązaniu problemu użytkownika. Przykład znajdziesz na stronie Rozwiązywanie problemów w Fedorze: https://docs.fedoraproject.org/en-US/fedora/rawhide/install-guide/install/troubleshooter/#sect-troubleshooting-forgot-help.

DLACZEGO TEN PROJEKT?

Pasjonuję się technologiami, a zwłaszcza cyberbezpieczeństwem i prywatnością. Uważam, że pisanie to jeden z moich najmocniejszych argumentów. Interesuje mnie Qubes OS, ponieważ łączy on moje 2 główne interesy: bezpieczeństwo i prywatność. Jestem wielokrotnym użytkownikiem innych usług zapewniających bezpieczeństwo i prywatność, takich jak DuckDuckGo i Tor. Odkryłam Qubes OS dopiero od niedawna i bardzo mi się podoba.

DLACZEGO UWAŻAM, ŻE JESTEM ODPOWIEDNIĄ OSOBĄ DO TEGO PROJEKTU

  • Pasjonuję się bezpieczeństwem, prywatnością i pisaniem dobrych/przydatnych dokumentów.
  • Mam problemy z instalacją i używaniem systemu operacyjnego Qubes, dlatego mogę je lepiej opisać w instrukcjach rozwiązywania problemów.
  • W zeszłym miesiącu przeanalizowaliśmy techniczne aspekty systemu operacyjnego Qubes. Zbadałem też dokładnie dokumentację Qubes OS. Aby ułatwić Ci zrozumienie procesu edytowania dokumentacji, utworzyłem żądanie pull (https://github.com/QubesOS/qubes-doc/pull/1005/files)
  • Odbyłam staż w projekcie Tor. Moimi rolami była pomoc techniczna i pisanie tekstów. Pracując w centrum pomocy, otrzymałem setki pytań od użytkowników, którzy mieli problemy z instalacją i korzystaniem z Tor Browser. Pomagając tym użytkownikom w rozwiązywaniu problemów, nauczyłam się zwięzłego i zrozumiałego sposobu rozwiązywania problemów
  • Pracując w Tor Project, pisałam także dokumentację techniczną z wykorzystaniem Markdown. Do kontroli wersji korzystałem z Git, GitHuba i GitLab.