이 페이지에는 Google Season of Docs에 선정된 기술 문서 프로젝트의 세부정보가 포함되어 있습니다.
프로젝트 요약
- 오픈소스 구성:
- FreeBSD 프로젝트
- 기술 문서 작성자:
- quaffeine
- 프로젝트 이름:
- Wine 핸드북 챕터 만들기
- 프로젝트 길이:
- 표준 기간 (3개월)
Project description
이 이니셔티브의 일환으로 FreeBSD에서 WINE (www.winehq.org)의 설치, 사용, 문제 해결과 관련된 FreeBSD 핸드북의 가이드 길이의 심층 챕터를 작성할 예정입니다. 달리 명시되지 않는 한 매주 4~8시간 동안 아래 항목을 처리하는 것을 목표로 합니다.
*** 커뮤니티 결속
선택되면 커뮤니티 결속 기간 동안 FreeBSD 프로젝트의 문서화 프로세스와 인프라를 숙지하는 데 시간을 보냅니다. 프로젝트에서 제공하는 일관된 문서에 항상 감탄했으며 프로젝트 팀원과 워크플로에 관해 논의하고자 합니다. 또한 사용자 중심 포럼에 가입하여 둘러보고 FreeBSD 사용자에게 일반적인 문서와 관련하여 도움이 되는 내용과 특히 FreeBSD에서 WINE을 사용하는 데 도움이 되는 내용을 파악합니다.
이 기간 동안 프로젝트의 문서 도구 모음을 학습하는 데 시간을 할애하겠습니다. 이렇게 하면 내가 선정될 경우 프로젝트 초반부터 바로 업무를 시작할 수 있습니다.
*** 1주 차 (9월 14일~19일): 테스트 설치 및 문제 해결
문서 개발 단계의 첫 주에는 FreeBSD의 현재 안정화 버전에서 WINE의 드라이 런 설치를 실행하고 간단한 유틸리티에서 더 복잡한 애플리케이션에 이르기까지 다양한 Windows 애플리케이션을 설치하고 실행합니다. 이것은 MakeUseOf용 ReactOS에 대한 저의 유사한 기사 (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/)에서 사용한 접근 방식입니다. 처음 한 주 동안에는 다양한 프로그램을 살펴보는 데만 사용할 수 있습니다.
제 경험에 비추어 볼 때, 이러한 사전 준비는 일반적인 '함정' 유형의 문제를 식별하고 해결하는 데 유용합니다. 이렇게 하면 관련 섹션을 작성할 때 솔루션을 준비하거나 적절한 채널에 지원을 요청할 수 있습니다.
이번 주 목표: 설치 챕터의 개요와 일반적인 설치 문제를 해결하는 방법에 관한 필수 세부정보를 확인합니다.
*** 2주차 (9월 21일~25일): WINE 설치 문서화
2주 차에는 실제로 다음을 포함하여 널리 사용되는 방법을 통한 WINE 설치를 보여주는 섹션의 초안을 작성할 것입니다.
- 포트 시스템을 사용하는 소스
- 핵심 저장소를 사용하는 바이너리 패키지를 통해
- 사용 가능한 GUI 패키지 관리자 사용(있는 경우)
- FreshPorts와 같은 대체 저장소 (및 사용자가 그렇게 하려는 이유)
이 섹션에서 중요한 것은 32비트와 64비트 및 동시 설치에 관한 논의로, 다양한 아키텍처의 프로그램을 실행하는 데 필요한 추가 단계를 강조합니다.
이번 주 목표: FreeBSD에 WINE를 설치하는 방법을 설명하는 섹션의 수정된 초안 버전 이 '수정된 초안'에는 거의 최종 텍스트 (교정 및 검토 의견 대기 중)와 스크린샷 자체가 아닌 스크린샷 자리표시자가 포함되어야 합니다.
*** 3주차 (9월 28일~10월 2일): FreeBSD에서 첫 번째 WINE 프로그램 실행
WINE 하위 시스템이 설치되면 다음 섹션에서 일부 초기 프로그램의 설치 및 실행을 자세히 설명합니다. 이러한 페이지는 오픈소스 Notepad++와 같은 간단한 독립형 유틸리티에 중점을 둘 가능성이 높습니다. 목표는 사용자가 애플리케이션을 빠르게 다운로드하고 설치한 후 최소한의 번거로움으로 작동하는지 확인할 수 있도록 하는 것입니다.
이 섹션은 일부 또는 많은 Windows 애플리케이션이 실제로 FreeBSD에서 실행될 수 있으므로 일상적인 컴퓨팅에 적합한 선택임을 사용자에게 보여주는 데 중요합니다.
이번 주 목표: 설치가 간편하고 대부분 즉시 작동하는 소수의 프로그램을 파악하고 설치를 보여주는 섹션의 수정된 초안 버전을 작성합니다.
*** 4주 차 (10월 5~9일): WINE 개요 및 개념
이전 섹션의 끝부분에서는 특정 애플리케이션이 WINE에서 작동하도록 하기 위해 약간의 조정 및 사용자 지정 작업이 필요하다는 것을 암시합니다. 이때 WINE 하위 시스템에 대한 소개는 컨텍스트를 제공하는 데 유용합니다. 이 섹션에서는 WINE 시스템에 포함된 항목, FreeBSD와 상호작용하는 방식, 사용자가 시스템을 자세히 이해하거나 문제를 해결하기 위해 살펴볼 수 있는 위치를 살펴봅니다.
이 섹션의 목적은 기존 리소스를 복제하는 것이 아니라 더 많은 정보를 얻을 수 있는 다른 (쉽게 소화할 수 있는) 소스로 연결되는 체계적인 개요를 제공하는 것입니다.
이번 주 목표: 사용자에게 WINE 하위 시스템을 소개하는 섹션의 수정된 초안을 작성합니다.
*** 5주차 (10월 12~16일): FreeBSD의 WINE 구성
본 항에서는 FreeBSD에 대한 전반적인 수정/조정부터 시작해서 WINE의 실제 구성에 대해 자세히 설명합니다. 또한 특정 애플리케이션의 WINE 환경을 맞춤설정하는 데 사용할 수 있는 $WINEPREFIX 폴더의 사용법도 보여줍니다. 이 개념을 자세히 설명하는 기존 리소스가 있으므로 이 섹션에서는 링크를 걸기 전에 적당히 자세한 소개만 제공합니다.
주간 목표: 심층적인 WINE 구성이 필요한 위치, 방법, 상황에 대해 상세하게 설명하는 섹션 초안
*** 6주차 (10월 19~23일): FreeBSD의 WINE GUI
특정 프로그램을 실행하도록 WINE을 설정하는 작업은 복잡하고 시간이 많이 걸릴 수 있으므로 이 프로세스를 더 쉽게 하는 도우미 도구가 있습니다. 이 섹션에서는 다음을 포함하여 FreeBSD에 있는 일부 옵션의 설치 및 사용에 대해 간략히 설명합니다.
- WINECfg
- winetricks
- playonbsd
- 기타(제공되는 경우)
이번 주 목표: 가능한 한 많은 인기 GUI WINE 도우미 애플리케이션을 설치하고 사용하는 방법에 관한 안내가 포함된 다듬어진 초안 섹션을 제공합니다.
*** 7주 차 (10월 26~30일): WINE/FreeBSD FAQ (리서치)
WINE과 같은 복잡한 기술 애플리케이션과 관련하여 가장 가치 있는 정보는 특정 문제를 해결하려는 사용자와 답변을 제공하는 전문가 간의 상호작용에서 찾을 수 있습니다. 이러한 FAQ 중 특히 FreeBSD 사용자에게 영향을 미치는 것으로 알려진 FAQ를 한곳으로 모으면 사용자의 시간이 절약됩니다.
이 섹션에서는 바로 이 문제를 해결하는 것을 목표로 합니다. 이번 주에는 FreeBSD 사용자가 WINE과 관련하여 흔히 겪는 문제 유형을 조사하고, 답변을 찾아서 (가능한 한) 테스트하는 데 집중할 예정입니다. 이렇게 하면 이 핸드북 챕터의 독자가 특정 문제를 더 빠르게 해결할 수 있습니다.
이 섹션에는 제공되지 않은 답변을 찾을 수 있는 리소스 목록도 포함됩니다.
이번 주 목표: FreeBSD 사용자 또는 일반적으로 발생하는 가장 일반적인 WINE 문제와 해결 방법에 관한 링크/메모가 포함된 다듬어진 초안 섹션을 작성합니다. 이번 주 작업에 초안 결과물이 없지만 일반적인 문제를 찾고 해결하고 솔루션을 추적하는 데 더 많은 시간을 투자해야 할 수 있습니다. 이 연구에 8~10시간 정도 소요될 것으로 예상됩니다.
*** 8주 차 (11월 2~6일): WINE/FreeBSD FAQ
이번 주에는 FAQ/일반적인 문제 해결 섹션을 만들기 위해 7주차 조사를 종합하고 적절한 해결 방법으로 연결합니다.
이번 주 목표: 자주 묻는 질문/자주 발생하는 문제 및 이를 해결하는 단계별 안내가 나열된 섹션의 수정된 초안을 작성합니다.
*** 9주 차 (11월 9~13일): 멀티 사용자 WINE 관리
이 섹션에서는 멀티 사용자 시나리오에서 WINE를 배포하려는 관리자에게 지침을 제공합니다. 여기에는 여러 사용자 간에 하위 시스템 자체를 공유하는 권장사항뿐만 아니라 WINE 내에 배포된 Windows 애플리케이션과 관련된 권장사항도 포함됩니다.
이번 주 목표: FreeBSD 관리자가 여러 사용자에게 WINE 및 WINE 기반 애플리케이션을 배포하기 위한 안내 및 권장사항을 자세히 설명하는 수정된 초안 섹션을 작성합니다.
*** 10주 차 (11월 16일~20일): 부록, 의견 검토 및 관리
초안 작성 과정에서 멘토와 다른 검토자로부터 받은 의견을 모두 반영하기 위해 노력하고 있지만, 이번 주에는 필요한 경우 더 광범위한 재구성/재작성을 할 수 있습니다.
또한 이 기간 동안 이 핸드북 챕터에 필요한 행정 문서 (앞부분, 색인 등)를 작성하고 WINE 관련 추가 자료 (예: 바이너리 호환성을 통해 WINE의 Linux 버전 사용, 오래된 게임/프로그램용 DOSBox 등)를 수집할 예정입니다.
이번 주 목표: 다른 모든 섹션을 포함하여 전체 핸드북 챕터의 수정된 초안을 작성합니다.
*** 11주 차 (11월 23~27일): 핸드북 챕터 마무리
이번 마지막 주에는 모든 텍스트의 교정, 이미지 확인, 필요에 따라 다양한 출력물 (HTML, PDF 등) 테스트에 집중할 계획입니다. 이번 주에는 위의 소프트웨어 (FreeBSD 자체부터 WINE 또는 그 도우미까지)가 초기 작성 이후 업그레이드되는 경우에도 업데이트가 가능합니다.
이번 주 목표: 모든 필수 업데이트를 포함한 핸드북 챕터의 최종 버전.
*** 12주차 (11월 30일~12월 5일): 프로젝트 마무리
프로젝트 멘토와 합의한 후 핸드북 챕터를 소스 제어로 확인하고 프로젝트 보고서를 조합한 후 프로젝트를 완료된 것으로 제출합니다.