polysh共有 / 実践ガイド
適切なアクセス権でチュートリアルを共有する。
仕上がった説明は、適切な人が適切なバージョンを開けて初めて完成です。送る前に、対象者を選び、ダウンロード設定を確認し、リンクをテストしましょう。
送りたい成果物を選ぶ。
完成した動画の書き出し、または見直し済みのガイドを選びます。ひとつのプロジェクトに複数のバージョンがある場合もあるため、リンクを作成する前に、共有するつもりの成果物そのものを視聴または確認しましょう。
動画のリンクは、作成時に対象とした書き出しを表示します。再度書き出しても、同じリンクの先のファイルは置き換わりません。ガイドのリンクは、後から見直した編集も含め、その言語の最新のガイドを表示します。
誰が開けるようにするかを決める。
広く回覧してもらうつもりの資料には、「リンクを知っている全員」の設定を使いましょう。招待したアドレスだけに説明を見せたい場合は、制限付きアクセスを使います。
制限付きアクセスのゲストは、招待されたメールアドレスをコードで確認します。対象者の状況を想定してテストしましょう。組織にログインしているチームメンバーと、リンクを開く外部ゲストとでは条件が異なります。
説明にまつわる細部を確認する。
- 録画やスクリーンショットに、チーム外に出すべきでない情報が含まれていないか確認する。
- ゲストに成果物のダウンロードを許可するかどうかを決める。
- リンクの有効期限やアクセス設定を確認する。
- 読み手が自分のソフトウェアでタスクを行うのに必要な権限を持っているか確認する。
アクセス制御は、内容の見直しの代わりにはなりません。同じ録画でも、手順に必要な以上の情報が映り込むことがあるため、成果物は慎重に選びましょう。
リンクをワークフローに合わせて最新に保つ。
動画を更新したら、新しい書き出し用のリンクを作成してテストします。ガイドを修正したら、既存のリンクを再送する前に現在のドキュメントを確認しましょう。
古い URL を無効にしたい場合は、リンクをリセットします。ガイドを再生成すると、ゲストによる編集を含め、選択した言語の手動編集が置き換えられることに注意してください。変更する前に共同作業者に伝えましょう。