このページには、Google シーズンのドキュメントで受け入れられているテクニカル ライティング プロジェクトの詳細が記載されています。
プロジェクトの概要
- オープンソースの組織:
- LibreOffice
- テクニカル ライター:
- quaffeine
- プロジェクト名:
- LibreOffice オンライン ガイド: 他の LO アプリケーションと同様のガイドで、使用方法だけでなくインストールと管理についても記載されています。
- プロジェクトの期間:
- 標準の期間（3 か月）
プロジェクトの説明
選ばれた場合、LibreOffice Online（LOOL）ガイドの作成のために、週に 8 ～ 10 時間かけて新しいコンテンツを作成するとともに、既存の Guide コンテンツを変更して再利用することを予定しています。普段書く頻度で、週に 8 ～ 10 時間かかる場合、約 200 ページ以上のガイドを制作できると思います。
私は StarOffice からこれらのアプリケーションを使用しており、次のような PC 版の高度な機能を使い慣れています。
- アプリケーション全体でのスタイル
- Writer のマスター ドキュメント、相互参照、図、デスクトップ パブリッシングの概念
- Calc のグラフ、グラフ、データ分析ツール
- Impress のインタラクティブなプレゼンテーション機能（切り替えやアニメーションなど）
仕事でもプライベートでも、この PC 版を幅広く使用しています。
このガイドの対象は、中程度の技術系のユーザーです。これらのユーザーは、LOOL のようなものを使いこなすスキル、忍耐力、そして最も重要なことに関心を持っている可能性が高いからです。参照という観点では、当然のことながらわかりやすい教育コンテンツ（選択箇所を太字にする方法など）が含まれているものの、いくつかの技術的コンセプトを理解していること（つまり、ウェブサーバーがアプリケーションをブラウザに提供する役割を担っていること）を前提とする必要があります。
まずは、以下のスケジュールに沿ってプロジェクトに取り組んでいきたいと思います。注: 私が書く章の順序は、必ずしも最終ガイドでの章の位置付けを示唆するものではありません。
第 1 週: インストール手順の確認、さまざまなインストール方法のテスト、アプリケーションの確認
今週の目標は、LOOL を正常に機能させることです。私の経験では、この種のアプリケーションを文書化する際に多くの小さな「問題」を発見するには、多くの時間を費やす必要があります。今週中に確認して、これらの障害に悩まされることなく、利用可能な任意の方法でアプリケーションを簡単にインストールできるようにしたいと考えています。
第 2 週: リファレンス インストールの実行、ドキュメントのインストール方法
今週は、インストール手順の大まかなリスト（完全な記述ではなく「数値」で記述）と、後の章で取り上げるいくつかの注記をまとめます。
第 3 週: 前書きのチャプターを書く - 前書き、導入、このガイドについて、など
今週の目標は、読者が実際のインストールに着手する前に必要な情報をすべて含む、完全な洗練された章を 1 つ以上用意することです。
第 4 週: インストール チャプターの作成、パート 1
今週の目標は、利用可能ないくつかのメソッドの完全で高度なインストール手順です。標準の LibreOffice Guide のチャプター形式ですが、Wiki などで簡単に再利用できる形式になっています。
第 5 週: インストール チャプターの作成、パート 2
今週の目標は、残りのメソッドの完全で高度なインストール手順です。標準の LibreOffice Guide のチャプター形式ですが、Wiki などで簡単に再利用できる形式になっています。
第 6 週: インストール後構成のチャプター
今週の目標は、アプリケーションの設定（タイムゾーンなど）の設定、ユーザーの設定、システムを本番環境に移行する前に管理者が行うその他の準備など、インストール後の構成に関する完全な、洗練された章です。
第 7 週: ナビゲーション、インターフェース、ファイル管理のチャプターの作成
今週の目標は、一読すれば、読み手が UI に慣れ親しみやすく、快適に作業できる、包括的で洗練された章です。
第 8 週: ライター（ワード プロセッシング）章の作成
今週は、ユーザーがアプリ内で直接魅力的なスタイルのドキュメントを作成できるように、完成された洗練された章を提示します。
第 9 週：計算（スプレッドシート）チャプターの書き込み
今週の目標は、完成された洗練された章で、サポートされる数式やチャート、グラフを含む実用的なスプレッドシートを作成できるようにすることです。
第 10 週: インプレッション（プレゼンテーション）のチャプターの書き込み
今週の目標は、完成された洗練されたチャプターです。ユーザーは、インタラクティブなプレゼンテーションを作成し、オフラインで使用するために出力したり、ライブ プレゼンテーションを行ったりできるようになります。
第 11 週: 書き込み統合のチャプター
第 11 週の目標は洗練され、利用可能な統合オプションの全体像をユーザーに提供します。アプリケーションを統合するための具体的なガイダンスは、Document Foundation の Wiki ページ、統合プロジェクトなど、関連リソースへのリンクの形になるでしょう。
12 週目: 雑貨（付録、インデックス、図表など）の組み立て初回パスの編集/校正
今週末には、ほぼ最終版のコンテンツと、相互参照などのそのままのまたは機能する要素をまとめた完全ガイドが用意されます。
13 週目: 2 回目のパスの編集/校正、タイプセット/レイアウトのチェック、送信
この最終週には、コンテンツとプレゼンテーションの両方を編集した、最終版ガイドの提出が行われます。