Projekt FreeBSD

Ta strona zawiera szczegółowe informacje na temat projektu technicznego przyjęta do programu Sezon Dokumentów Google.

Podsumowanie projektu

Organizacja open source:

Projekt FreeBSD

Pisarz techniczny:

kafeina

Nazwa projektu:

Utwórz rozdział w podręczniku Wine

Długość projektu:

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

Opis projektu

W ramach tej inicjatywy przygotowałam obszerny rozdział podręcznika FreeBSD dotyczący instalacji, użytkowania i rozwiązywania problemów WINE (www.winehq.org) na FreeBSD. Będę potrzebować 4–8 godzin tygodniowo na pracę nad poniższymi elementami, chyba że zaznaczono inaczej.

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

Jeśli się zdecyduję, poświęcę czas na stworzenie więzi z nami, by zapoznać się z procesami i infrastrukturą projektu FreeBSD. Zawsze byłam pod wrażeniem spójnej dokumentacji opracowanej w ramach projektu. Nawiązuję kontakt z członkami zespołu zajmującymi się projektem i kontaktuję się z nim w sprawie przepływu pracy. Będę też dołączać do forów dla użytkowników, aby zorientować się, co mogłoby pomóc użytkownikom FreeBSD w odniesieniu do dokumentacji w ogóle, a w szczególności pomóc we współpracy z WINE nad FreeBSD.

W tym czasie poświęcę trochę czasu na poznawanie łańcucha narzędzi do dokumentacji projektu. Jeśli wybierzemy się do tego programu, pozwoli mi to rozpocząć pracę już w pierwszych tygodniach projektu.

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

Spędziłem pierwszy tydzień fazy tworzenia dokumentów, wykonując próbne instalację WINE w obecnej stabilnej wersji FreeBSD, a także na instalowanie i uruchamianie różnych aplikacji systemu Windows – od prostych narzędzi po bardziej złożone aplikacje. To podejście przyjęłam w podobnym artykule na temat systemu ReactOS for MakeUseOf (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/), ale w pierwszym tygodniu zapoznawałem się z większą liczbą programów.

Z mojego doświadczenia wynika, że spędzanie tego czasu na wstępie przydaje się w wykrywaniu ogólnych problemów typu „gotcha” i ich rozwiązywaniu. Dzięki temu będę mieć dostęp do tych rozwiązań, gdy nadejdzie pora na utworzenie odpowiednich sekcji lub chociaż poproszę odpowiednie kanały o pomoc.

Cel tygodnia: aby uzyskać zarys rozdziałów instalacji i wymagane informacje dotyczące rozwiązywania typowych problemów z instalacją.

*** Tydzień 2. (21.09–25.09): Dokumentowanie instalacji WINE

W tygodniu 2 przygotowałem kilka sekcji ilustrujących instalację WINE za pomocą popularnych metod, takich jak:

• Ze źródła za pomocą systemu portów.
• za pomocą pakietów binarnych korzystających z podstawowych repozytoriów;
• korzystanie z dostępnych menedżerów pakietów GUI, jeśli są dostępne;
• Z repozytoriów alternatywnych, takich jak FreshPorts (oraz dlaczego użytkownik chce to zrobić).

W tej sekcji ważne jest omówienie instalacji 32- i 64-bitowych oraz jednoczesnych, aby podkreślić dodatkowe kroki wymagane przez programy działające w różnych architekturach.

Cel tygodnia: dopracowana wersja robocza sekcji opisujących instalację programu WINE w witrynie FreeBSD. „Dopracowana wersja robocza” powinna zawierać niemal ostateczny tekst (oczekujący na korektę i opinię) oraz obiekty zastępcze dla zrzutów ekranu, jeśli nie są to same zrzuty ekranu.

*** Tydzień 3. (28.10.2020): Uruchomienie pierwszego programu WINE na FreeBSD

Po zainstalowaniu podsystemu WINE w następnej sekcji znajdziesz szczegółowe informacje na temat instalacji i uruchomienia kilku programów początkowych. Najprawdopodobniej będą to proste, samodzielne narzędzia, takie jak Notepad++ typu open source. Celem jest umożliwienie użytkownikom szybkiego pobrania aplikacji, zainstalowania jej i sprawdzenia, jak działa ona w minimalnym stopniu.

W tej sekcji warto pokazać użytkownikom, że niektóre aplikacje Windows działają na zasadzie FreeBSD, dzięki czemu można używać ich na co dzień.

Cel tygodnia: wskazanie niewielkiej liczby programów, które instalują się prawidłowo i (w większości) działają po uruchomieniu, oraz dopracowana wersja robocza sekcji ilustrująca ich instalację.

*** Tydzień 4 (5–9 października): WINE omówienie i koncepcje

Koniec poprzedniej sekcji sugerowałby konieczność dostrajania i dostosowywania niektórych aplikacji do pracy w WINE. W tym momencie przydatne jest wprowadzenie do podsystemu WINE. W tych sekcjach opisano, co wchodzi w skład systemu WINE, jak współpracuje on z FreeBSD oraz gdzie można zacząć szukać bardziej szczegółowych informacji o systemie lub rozwiązywaniu dotyczących go problemów.

Pamiętaj, że ta sekcja nie ma na celu duplikowania istniejących zasobów, ale przedstawia uporządkowany przegląd z linkami do innych (łatwo przystępnych) źródeł informacji.

Cel tygodnia: dopracowana wersja robocza sekcji prezentujących podsystem WINE użytkownikom.

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

W tych sekcjach znajdziesz bardziej szczegółowe informacje o rzeczywistej konfiguracji WINE, zaczynając od ogólnych modyfikacji lub dostrajania pod kątem FreeBSD. Pokazaliby również użycie folderów $WINEPREFIX, których można użyć do dostosowania środowiska WINE do konkretnej aplikacji. Istnieją już materiały, które szczegółowo wyjaśniają tę koncepcję, dlatego ta sekcja zawiera tylko umiarkowanie szczegółowe wprowadzenie, zanim przejdziemy do źródeł.

Cele tygodnia: dopracowana wersja robocza sekcji z opisem miejsc, sposobów i okoliczności wymagających szczegółowej konfiguracji WINE.

*** Tydzień 6 (19–23 października): faktury GUI firmy WINE na FreeBSD

Konfiguracja WINE pod kątem realizacji danego programu może być złożonym i czasochłonnym zadaniem, dlatego istnieją narzędzia pomocnicze, które to ułatwiają. W tych sekcjach znajdziesz omówienie instalacji i wykorzystania niektórych opcji dostępnych w FreeBSD, takich jak:

• WINECfg
• sztuczki z winem
• Playonbsd
• inne jako dostępne

Cel tygodnia: udostępnienie dopracowanych sekcji roboczych z instrukcjami instalowania i używania jak największej liczby najpopularniejszych aplikacji pomocniczych GUI WINE.

*** Tydzień 7 (26–30 października): Najczęstsze pytania dotyczące WINE/FreeBSD (badania)

Niektóre najcenniejsze informacje dotyczące złożonych zastosowań technicznych, takich jak WINE, można znaleźć w rozmowie między użytkownikami próbującymi rozwiązać konkretne problemy a ekspertami udzielającymi odpowiedzi. Zbierze się w jednym miejscu niektóre z najczęstszych pytań, zwłaszcza te, które mają wpływ na użytkowników FreeBSD. Dzięki temu zaoszczędzą oni sporo czasu.

W tym celu skorzystam z tych sekcji. W tym tygodniu warto byłoby sprawdzić, jakie problemy często występują w systemie FreeBSD, a także szukać odpowiedzi i (w miarę możliwości) testować odpowiedzi. Dzięki temu czytelnicy tego rozdziału będą mieli znacznie większe szanse na szybkie rozwiązanie konkretnego problemu.

Znajdą się w niej również listę zasobów, w których można szukać odpowiedzi, których nie udało się znaleźć.

Cel tygodnia: poprawione wersje robocze sekcji zawierające najczęstsze problemy z WINE(z perspektywy użytkowników FreeBSD) i ogólnie oraz linki/uwagi dotyczące ich rozwiązań. Pamiętaj, że chociaż w tym tygodniu nie ma wersji roboczej projektu, znalezienie i porozumienie typowych problemów oraz znalezienie ich rozwiązań prawdopodobnie będzie wymagało więcej czasu. Spodziewam się, że poświęcę na to 8–10 godzin.

*** Tydzień 8 (2–6 listopada): WINE/FreeBSD – najczęstsze pytania

Poświęcimy w tym tygodniu analizę wyników z 7 tygodnia, aby utworzyć sekcje na temat najczęstszych pytań i typowych problemów związanych z rozwiązywaniem problemów (podawanie linków do odpowiednich rozwiązań).

Cel tygodnia: dopracowana wersja sekcji z listą najczęstszych pytań i najczęstszych problemów oraz szczegółowymi instrukcjami ich rozwiązywania.

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

Te sekcje zawierają wskazówki dla administratorów, którzy chcą wdrożyć WINE w sytuacjach, w których korzysta wielu użytkowników. Obejmują one nie tylko sprawdzone metody udostępniania tego podsystemu wielu użytkownikom, ale także aplikacji Windows wdrożonych w WINE.

Cel tygodnia: dopracowane sekcje robocze ze szczegółowymi wskazówkami i sprawdzonymi metodami dla administratorów FreeBSD dotyczących wdrażania aplikacji opartych na WINE i WINE dla wielu użytkowników.

*** Tydzień 10.11–20.11: Dodatki, opinie i administracja

Staramy się wykorzystać opinie mentorów i innych weryfikatorów w trakcie opracowywania wersji roboczej. W tym tygodniu zyska Pan/Pani czas na szerszą reorganizację lub przeredagowanie tekstu, jeśli zajdzie taka potrzeba.

Dodatkowo napisałbym też wszelkie informacje administracyjne wymagane w tym rozdziale podręcznika (przedstawiona sprawa, indeksy itp.), a także przygotowałam informacje na temat sieci WiNE (np. za pomocą WINE w wersji dla systemu Linux, korzystając ze zgodności plików binarnych, systemu DOSBox ze starymi grami/programami itp.).

Cel tygodnia: dopracowana wersja robocza całego rozdziału Podręcznika wraz ze wszystkimi innymi sekcjami.

*** Tydzień 11. (23.11–27.11): zakończenie rozdziału podręcznika

Ten ostatni tydzień chcę poświęcić na korektę całego tekstu, sprawdzanie obrazów i testowanie różnych wyników (HTML, PDF itp.) w zależności od potrzeb. W tym tygodniu będzie można również aktualizować oprogramowanie w sytuacji, gdy jakiekolwiek z powyższych programów (od FreeBSD, WINE i jego pomocników) zostanie uaktualnione w czasie od jego początkowego utworzenia.

Cel tygodnia: ostatnia wersja rozdziału Podręcznika, zawierająca wszystkie wymagane aktualizacje.

*** Tydzień 12. (30.11–5.12): Finalizacja projektu

Zgodnie z porozumieniem z mentorami pracującymi nad projektem sprawdzam źródło projektu w sekcji „Podręcznik”, przygotowuję raport i przesyłam projekt jako ukończony.