Projekt FreeBSD

Ta strona zawiera szczegóły projektu technicznego do pisania w sezonie Dokumentów Google.

Podsumowanie projektu

Organizacja open source

Projekt FreeBSD

Pisarz techniczny:

quaffeine

Nazwa projektu:

Tworzenie rozdziału podręcznika Wine

Długość projektu:

Standardowa długość (3 miesiące)

Opis projektu

W ramach tej inicjatywy chciałbym napisać obszerny rozdział w Podręczniku FreeBSD dotyczący instalacji, użytkowania i rozwiązywania problemów z WINE (www.winehq.org) w FreeBSD. O ile nie zaznaczono inaczej, na realizację zadań wymienionych poniżej będę poświęcać 4–8 godzin tygodniowo.

*** Budowanie więzi ze społecznością

Jeśli zostanę wybrany, wykorzystam okres nawiązywania więzi ze społecznością, aby zapoznać się z procesami i infrastrukturą dokumentacji projektu FreeBSD. Zawsze byłem pod wrażeniem spójnej dokumentacji projektu i chętnie współpracowałem z członkami zespołu nad ich przepływem pracy. Dołączam też do forów dla użytkowników, aby dowiedzieć się, co mogłoby pomóc użytkownikom FreeBSD w zakresie ogólnej dokumentacji, a zwłaszcza w pracy z WINE w ramach FreeBSD.

W tym okresie spędziłbym trochę czasu na poznawaniu łańcucha narzędzi do dokumentacji projektu. Pozwoli mi to szybko rozpocząć pracę nad projektem w pierwszych tygodniach, jeśli zostanę wybrana.

*** Tydzień 1 (14–19 września): testowanie instalacji i rozwiązywanie problemów

Pierwszy tydzień na etapie tworzenia dokumentu poświęcam na instalację testową WINE w obecnej stabilnej wersji FreeBSD, a także na instalowanie i uruchamianie różnych aplikacji Windows, od prostych narzędzi po bardziej złożone. Takie podejście zastosowałem w poprzednim artykule na temat ReactOS na stronie MakeUseOf (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/), ale w pierwszym tygodniu chciałem sprawdzić większą liczbę programów.

Z moich doświadczeń wynika, że poświęcenie na to czasu na początku jest przydatne do wykrywania (i rozwiązywania) ogólnych problemów typu „gotcha”. Dzięki temu będę mieć gotowe rozwiązania, gdy przyjdzie czas na napisanie odpowiednich sekcji, lub przynajmniej będę mieć prośby o pomoc wysłane do odpowiednich kanałów.

Cel na tydzień: zapoznaj się z omówieniem rozdziałów dotyczących instalacji oraz z informacjami na temat rozwiązywania typowych problemów z instalacją.

*** Tydzień 2 (21–25 września): dokumentowanie instalacji WINE

W 2. tygodniu sporządzam szkic sekcji ilustrujących instalację WINE za pomocą popularnych metod, w tym:

• z źródła za pomocą systemu portów;
• za pomocą pakietów binarnych przy użyciu podstawowych repozytoriów;
• za pomocą dostępnych menedżerów pakietów z interfejsem graficznym (jeśli są dostępne);
• z alternatywnych repozytoriów, takich jak FreshPorts (i dlaczego użytkownik chce to zrobić).

W tej sekcji omówiono znaczenie 32- i 64-bitowych instalacji oraz jednoczesnych instalacji, aby pokazać dodatkowe czynności wymagane do uruchamiania programów w różnych architekturach.

Cel na tydzień: dopracowany szkic sekcji opisujących instalację WINE w FreeBSD. Ten „dopracowany projekt” powinien zawierać tekst w prawie ostatecznej formie (oczekujący na korektę i opinię) oraz obiekty zastępcze zrzutów ekranu (jeśli nie są to zrzuty ekranu).

*** Tydzień 3 (28.09-10.02): Pierwszy program WINE na platformie FreeBSD

Po zainstalowaniu podsystemu WINE w następnej sekcji opisano szczegółowo instalację i wykonanie niektórych początkowych programów. Najprawdopodobniej będą to proste, samodzielne narzędzia, takie jak Notepad++ na licencji open source. Celem jest umożliwienie użytkownikom szybkiego pobierania i instalowania aplikacji oraz jej uruchamiania bez zbędnych komplikacji.

Ta sekcja ma pokazać użytkownikom, że niektóre lub nawet wiele aplikacji Windows może działać w FreeBSD, co czyni z niego atrakcyjną opcję dla codziennego użytkowania.

Cel na tydzień: znalezienie kilku programów, które można zainstalować bezproblemowo i które działają (w większości) od razu po zainstalowaniu, oraz dopracowanie wersji roboczej sekcji przedstawiającej ich instalację.

*** Tydzień 4 (5–9 października): przegląd i koncepcje WINE

W poprzedniej sekcji wspomniano, że aby niektóre aplikacje działały w WINE, trzeba je dostosować i skonfigurować. W tym celu warto zapoznać się z wprowadzeniem do tego, czym jest subsystem WINE. Te sekcje zawierałyby informacje o tym, co zawiera system WINE, jak współdziała z FreeBSD oraz gdzie użytkownik może zacząć szukać, aby lepiej zrozumieć system lub rozwiązać problemy.

Pamiętaj, że w tej sekcji nie chodzi o powielanie istniejących zasobów, tylko o uporządkowany przegląd z linkami do innych (łatwo przyswajalnych) źródeł, w których znajdziesz więcej informacji.

Cel tygodnia: dopracowana wersja robocza sekcji wprowadzających użytkowników w podsystem WINE.

*** Tydzień 5 (12–16 października): konfiguracja WINE w FreeBSD

Te sekcje zawierałyby szczegółowe informacje o rzeczywistej konfiguracji WINE, począwszy od ogólnych modyfikacji i dostosowań dotyczących FreeBSD. Pokażą one również użycie folderów $WINEPREFIX, które można wykorzystać do dostosowania środowiska WINE do konkretnej aplikacji. Istnieją już materiały, które szczegółowo omawiają ten temat, dlatego w tej sekcji znajdziesz tylko ogólne wprowadzenie, a następnie znajdziesz linki do tych materiałów.

Cele tygodnia: dopracowany projekt sekcji, w których szczegółowo opisano, gdzie, jak i w jakich okolicznościach wymagana jest szczegółowa konfiguracja WINE.

*** Tydzień 6 (19.10–23.10): faktura GUI w zakresie wina w ramach FreeBSD

O ile konfiguracja WINE do realizacji danego programu może być skomplikowana i czasochłonna, istnieją narzędzia pomocnicze, które ułatwiają ten proces. Te sekcje powinny zawierać omówienie instalacji i używania niektórych opcji dostępnych w FreeBSD, w tym:

• WINECfg
• winetricks
• playonbsd
• inne, jeśli są dostępne

Cel tygodnia: udostępnienie ukończonych sekcji z instrukcjami instalacji i korzystania z jak największej liczby najpopularniejszych aplikacji pomocniczych WINE z interfejsem graficznym.

*** Tydzień 7 (26.10–30:00–30:00 – WINE/FreeBSD – najczęstsze pytania (badania)

Niektóre z najcenniejszych informacji dotyczących złożonych aplikacji technicznych, takich jak WINE, można znaleźć w interakcjach między użytkownikami próbującymi rozwiązać konkretne problemy a ekspertami udzielającymi odpowiedzi. Zbierając w jednym miejscu niektóre z najczęstszych pytań, szczególnie tych, które mają wpływ na użytkowników FreeBSD, można zaoszczędzić dużo czasu.

W tym celu w tym tygodniu będę się zajmować wyłącznie badaniem typów problemów, które użytkownicy FreeBSD często napotykają w WINE, a także znajdowaniem i (w miarę możliwości) testowaniem rozwiązań. Dzięki temu czytelnicy tego rozdziału poradnika będą mieli znacznie większe szanse na szybkie rozwiązanie konkretnego problemu.

Sekcje te powinny zawierać listę zasobów, w których można znaleźć odpowiedzi na pytania, na które nie udzielono odpowiedzi.

Cel na tydzień: dopracowane sekcje zawierające najczęściej występujące problemy z WINE, które występują u użytkowników FreeBSD lub są powszechne, oraz linki i notatki dotyczące ich rozwiązań. Pamiętaj, że choć w tym tygodniu nie było wersji roboczej, znalezienie i zgodność z typowymi problemami oraz ich rozwiązanie prawdopodobnie zajmą więcej czasu. Spodziewam się, że te badania zajmą mi 8–10 godzin.

*** Tydzień 8 (2–6 XI): najczęstsze pytania dotyczące WINE i FreeBSD

Ten tydzień będzie poświęcony na syntetyzowanie badań z 7. tygodnia w celu utworzenia sekcji z najczęstszymi pytaniami i typowymi problemami (z odpowiednimi linkami do rozwiązań).

Cel tygodnia: dopracowana wersja robocza sekcji z listą najczęstszych pytań i częstych problemów oraz szczegółowych instrukcji, jak je rozwiązać.

*** Tydzień 9 (9–13 listopada): administracja WINE dla wielu użytkowników

Te sekcje zawierałyby wskazówki dla administratorów, którzy chcą wdrożyć WINE w sytuacji wielu użytkowników. Obejmowałoby ono nie tylko sprawdzone metody udostępniania danego podsystemu wielu użytkownikom, ale też stosowanie aplikacji Windows w ramach WINE.

Cel tygodnia: dopracowana wersja robocza z dopracowanymi wskazówkami i sprawdzonymi metodami dla administratorów FreeBSD związanymi z wdrażaniem aplikacji opartych na WINE i WINE u wielu użytkowników.

*** Tydzień 10 (16.11.2020): załączniki, opinie na temat opinii i administracja

Staram się uwzględniać wszystkie opinie mentorów i innych recenzentów podczas pisania, ale w tym tygodniu będę mieć czas na bardziej rozbudowaną reorganizację i przepisanie tekstu, jeśli zajdzie taka potrzeba.

W tym czasie napiszę też wszelkie informacje administracyjne wymagane w tym rozdziale podręcznika (wstęp, indeksy itp.), a także przygotuję materiały dodatkowe związane z WINE (np. korzystanie z wersji WINE dla Linuksa dzięki zgodności binarnej, DOSBox do starych gier/programów itp.).

Cel tygodnia: dopracowany projekt całego rozdziału w podręczniku, w tym wszystkich innych sekcji.

*** Tydzień 11 (23–27 listopada): ostateczne opracowanie rozdziału podręcznika

Od drugiego do ubiegłego tygodnia chciałabym poświęcić go na korektę całego tekstu, sprawdzenie obrazów i przetestowanie różnych wyników (HTML, PDF itp.) w razie potrzeby. W tym tygodniu będzie można też wprowadzić aktualizacje, jeśli któreś z wymienionych wyżej programów (od FreeBSD po WINE i powiązane z nimi narzędzia) zostanie uaktualnione od czasu napisania tego artykułu.

Cel tygodnia: ostateczna wersja rozdziału podręcznika, ze wszystkimi wymaganymi aktualizacjami.

*** Tydzień 12 (30 XI–5 XII): zakończenie projektu

Zgodnie z uzgodnieniem z mentorami projektu, wprowadź rozdział podręcznika do kontroli wersji, przygotuj raport z projektu i prześlij projekt jako ukończony.