このページには、Google シーズンのドキュメントで受け入れられているテクニカル ライティング プロジェクトの詳細が記載されています。
プロジェクトの概要
- オープンソースの組織:
- FreeBSD プロジェクト
- テクニカル ライター:
- quaffeine
- プロジェクト名:
- ワイン ハンドブックの章を作成する
- プロジェクトの期間:
- 標準の期間（3 か月）
プロジェクトの説明
この取り組みの一環として、FreeBSD ハンドブックの中で、FreeBSD 上の WINE (www.winehq.org) のインストール、使用、およびトラブルシューティングについて詳しく説明した、本編の章を制作します。特に記載がない限り、週に 4 ～ 8 時間かけて以下の項目を担当したいと思います。
*** コミュニティの絆
選ばれた場合、コミュニティ ボンディング期間を設けて、FreeBSD プロジェクトのドキュメント プロセスとインフラストラクチャに習熟します。プロジェクトによってまとめられたドキュメントにいつも感銘を受けています。また、プロジェクトのチームメンバーとワークフローのやり取りをしたいと思っています。また、ユーザー指向のフォーラムに参加して閲覧し、一般的なドキュメントに関して FreeBSD のユーザーに役立つ内容を把握し、特に FreeBSD の WINE との作業を支援したいと思います。
この間、少し時間をかけてプロジェクトのドキュメント ツールチェーンについて学びたいと思います。これにより、選ばれた場合、プロジェクト初期の数週間の活動に着手できます。
*** 第 1 週（9 月 14 ～ 19 日）: インストールのテストとトラブルシューティング
Doc Development フェーズの 1 週目は、FreeBSD の現在の安定版に WINE のドライラン インストールを行い、シンプルなユーティリティからより複雑なアプリケーションまで、さまざまな Windows アプリケーションをインストールして実行します。これは、ReactOS for MakeUseOf で行った同様の記事（https://www.makeuseof.com/tag/reactos-open-source-windows-clone/）で行った同様の記事で採用したアプローチです。1 週目の時間を使って、より幅広いプログラムを調べるだけです。
私の経験上、この種の事前の準備は、一般的な「問題」の特定（およびトラブルシューティング）に役立ちます。そうすれば、実際に関連するセクションを記述したり、少なくとも適切なチャネルにサポートを依頼したりするときに、解決策を手元に置くことができます。
週の目標: インストールの各章の概要と、インストールに関する一般的な問題の解決方法について必要な詳細情報をまとめます。
*** 第 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 システムの付属品、FreeBSD との相互作用、およびユーザーがシステムの理解を深め、問題をトラブルシューティングするためにどのようなところから始められるかを調査します。
このセクションでは、既存のリソースを複製することを目的としているのではなく、他の（わかりやすい）情報源にリンクして、詳細を整理して概要を示します。
週の目標: WINE サブシステムをユーザーに紹介するセクションの洗練されたドラフト。
*** 第 5 週（10/12 ～ 16）: FreeBSD での WINE 構成
これらのセクションでは、WINE の実際の構成についてさらに掘り下げ、最初に FreeBSD に固有の全体的な変更や調整を行います。また、$WINEPREFIX フォルダの使用も説明されています。このフォルダを使用して、特定のアプリケーション用に WINE 環境をカスタマイズすることができます。この概念を詳しく説明するリソースがすでに存在するため、このセクションでは、リンクする前に、やや詳細な紹介のみを提供します。
週の目標: WINE の詳細な構成が必要な場所、方法、状況について詳しく説明したセクションの下書きです。
*** 第 6 週（10/19 ～ 23）: FreeBSD のワイン GUI
あるプログラムを実行するために WINE をセットアップするのは複雑で時間がかかる作業になりかねませんが、このプロセスを容易にするヘルパーツールがあります。このセクションでは、FreeBSD に存在する次のようなオプションのインストールと使用について概説します。
- WINECfg
- ワイントリック
- Playonbsd
- 他に利用可能なものは
週の目標: 人気の高い GUI WINE ヘルパー アプリケーションをできるだけ多くインストールして使用する手順を記載した、洗練されたドラフト セクションを提供する。
*** 第 7 週（10/26 ～ 30）: WINE/FreeBSD に関するよくある質問（調査）
WINE のような複雑な技術アプリケーションに関する最も有益な情報の一部は、特定の問題を解決しようとするユーザーと、それに回答する専門家の間のやりとりの中にあります。これらのよくある質問、特に FreeBSD ユーザーに影響することが知られているよくある質問の一部を 1 か所に集めておくと、ユーザーの時間を大幅に節約できます。
これらのセクションはまさにそれを目指しており、今週は、FreeBSD ユーザーが WINE についてよくある問題の種類を調査し、答えを見つけて（可能な範囲で）テストします。これにより、このハンドブックの読者は特定の問題を迅速に解決できる可能性が高くなります。
このセクションには、提供されていない回答をどこで確認できるリソースのリストも含まれます。
週の目標: FreeBSD ユーザーが経験する、または一般的な WINE の一般的な問題と、その解決策に関するリンク/メモを含む、洗練されたドラフト セクション今週の作業には下書きの出稿はありませんが、一般的な問題を見つけて調整し、解決策を突き止めるためには、より多くの時間の投資が必要になる可能性があります。この調査には 8 ～ 10 時間ほどかける予定です。
*** 第 8 週（11/2 ～ 6）: WINE/FreeBSD に関するよくある質問
今週は、第 7 週の調査をまとめて、よくある質問/よくあるトラブルシューティングに関する問題のセクション（必要に応じてソリューションへのリンクを含む）を作成します。
週の目標: よくある質問やよくある問題をリストアップし、それらを解決するための詳細な手順を記載したセクションの洗練されたドラフト。
*** 第 9 週（11/9 ～ 13）: マルチユーザー WINE の管理
このセクションでは、マルチユーザー シナリオでの WINE のデプロイを検討している管理者向けのガイダンスを提供します。これには、サブシステム自体を複数のユーザー間で共有するためのベスト プラクティスだけでなく、WINE 内にデプロイされた Windows アプリケーションに関するベスト プラクティスも含まれています。
週の目標: FreeBSD 管理者が WINE および WINE ベースのアプリケーションを複数のユーザーにデプロイするためのガイダンスとベスト プラクティスについて詳しく説明した、洗練されたドラフト セクション
*** 第 10 週（11/16 ～ 20）: 付録、レビューのフィードバック、管理
メンターやその他のレビュアーからいただいたフィードバックは、下書きの段階でもすべて取り入れられるように努めますが、今週は必要に応じて、より広範な再編成/書き直しを行う時間があります。
さらに、このハンドブックの章に必要な管理情報（前科、インデックスなど）を執筆するとともに、WINE 関連のさらなる資料を組み立てます（バイナリ互換性を通した Linux バージョンの WINE、古いゲームやプログラム向けの DOSBox など）。
「今週の目標」: ハンドブックの章全体を、その他すべてのセクションを含んだ、洗練された下書きです。
*** 第 11 週（11/23 ～ 27）: ハンドブックのチャプターの最終処理
今週から 2 週目までは、必要に応じてすべてのテキストの校正、画像のチェック、さまざまな出力（HTML、PDF など）のテストに専念する予定です。また、今週は、上記のソフトウェア（FreeBSD 自体から WINE またはそのヘルパー）のいずれかが最初の作成以降にアップグレードされた場合にもアップデートの対象となります。
週の目標: ハンドブックの章の最終版。必要なすべての更新を含めます。
*** 第 12 週（11/30 ～ 12/5）: プロジェクト確定
プロジェクトのメンターの同意を得たうえで、ハンドブックの章でソース管理を確認し、プロジェクト レポートを作成して、完了したプロジェクトを提出します。