プロジェクトの要約ページを表示および更新する

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

各プロジェクトには、情報を共有し、最新のプロジェクトアクティビティを紹介するための要約またはホームページが用意されています。このページは、チームメンバーがプロジェクトの進捗状況に関する最新情報を常に把握するための中心的なハブとして機能します。このページは、次のタスクに使用します。

重要なプロジェクトの更新情報とお知らせを共有する
最近のアクティビティとマイルストーンを強調表示する
主要なプロジェクトリソースとドキュメントへの迅速なアクセスを提供する
チームのコラボレーションとコミュニケーションを促進する

プロジェクトの要約ページを使用して、より具体的なタスクも実行します。

プロジェクト管理者のタスク

プロジェクトメンバーのタスク

簡略なプロジェクトの説明を追加する
プロジェクト情報の README ファイルまたは Wiki を選択する
プロジェクトを共同作成するユーザーを招待する
プロジェクトタグを設定する

プロジェクト情報を表示する
プロジェクトアクティビティを表示する
プロジェクトをお気に入りに追加する
チームメンバーにメールを送信またはチャットを開始する
プロジェクト全体で検索を開始する
プロジェクト情報を表示する
チームメンバーにメールを送信またはチャットを開始する
プロジェクトアクティビティを表示する

Note

ホストされているプロジェクトを [非公開] または [公開] と指定できます。パブリックプロジェクトの場合、匿名ユーザーは メンバー セクションを除き、プロジェクト要約を表示できます。また、[いいね!] と [お気に入り] アイコンは匿名ユーザーには表示されません。詳細については、「公開プロジェクトとは」を参照してください。

要約ページのスクリーンショット。

前提条件

カテゴリ	必要条件
アクセス許可	プロジェクト管理者グループのメンバーであるか、以下のタスクを実行できるようにプロジェクトレベルの情報を編集するアクセス許可が [許可] に設定されていること。 - プロジェクトページの情報を編集します。 - プロジェクト情報の共有に使用するリポジトリを変更します。 - プロジェクトメンバーシップを管理します。特定のタスク: - プロジェクトページを編集するには: リポジトリまたはブランチの共同作成者であるか、Contribute アクセス許可が [許可] に設定されている必要があります。 - プロジェクトの概要を表示するには: プロジェクトの有効なメンバーである必要があります。 - プロジェクトタグを追加または編集するには: プロジェクトレベルでプロパティの管理アクセス許可が [許可] に設定されている必要があります。このアクセス許可により、プロジェクトのプロパティ REST API を制御します。

カテゴリ

必要条件

アクセス許可

プロジェクト管理者グループのメンバーであるか、以下のタスクを実行できるようにプロジェクトレベルの情報を編集するアクセス許可が [許可] に設定されていること。
- プロジェクトページの情報を編集します。
- プロジェクト情報の共有に使用するリポジトリを変更します。
- プロジェクトメンバーシップを管理します。
特定のタスク:
- プロジェクトページを編集するには: リポジトリまたはブランチの共同作成者であるか、Contribute アクセス許可が [許可] に設定されている必要があります。
- プロジェクトの概要を表示するには: プロジェクトの有効なメンバーである必要があります。
- プロジェクトタグを追加または編集するには: プロジェクトレベルでプロパティの管理アクセス許可が [許可] に設定されている必要があります。このアクセス許可により、プロジェクトのプロパティ REST API を制御します。

ヒント

ページの編集や機能の使用に必要なアクセス許可がない場合、対応するアイコンとリンクは表示されません。

プロジェクトの要約を開く

Web ブラウザーで [概要]>[要約] を選択します。プロジェクトがまだない場合は、プロジェクトを作成します。

プロジェクトの要約がまだ設定されていない場合は、ウェルカムページが表示されます。

作業を開始するには、次のいずれかを選択してください。

[招待]。他のユーザーのプロジェクトへの追加を開始します。組織に追加されたユーザーのみを招待できます。
[ボード]。作業項目の追加を開始します。
[リポジトリ]。[リポジトリ]>[ファイル] ページを開くと、リポジトリのクローンやインポートを行い、プロジェクトの要約ページに合わせて README ファイルを作成することができます。
[パイプライン]。パイプラインの定義を作成します。
[Test Plans]。テスト計画とテストスイートの定義を作成します。
[サービスの管理]。1 つ以上のサービスの可視性を無効にします。

要約ページを更新する

要約ページには、プロジェクトリポジトリで定義されている README ファイルまたはプロジェクト Wiki のホームページが表示されます。プロジェクト Wiki ホームページを使用するには、プロジェクトの wiki を作成し、プロジェクトの要約ページが Wiki を指すように変更できます。

ページを編集します。
- ページを初めて編集する場合は、[プロジェクトの説明の追加] を選択します。
- 初めてのページ編集ではない場合は、[プロジェクト情報の編集] を選択します。このアイコンは、プロジェクトの [要約] ページを編集する権限を持つメンバーにのみ表示されます。
プロジェクトの目的の簡単な説明を [説明] ボックスに入力します。
(省略可能) プロジェクトに 1 つ以上の [タグ] を追加します。これらのタグは、作業項目タグに似ています。コンマ区切り記号またはセミコロン区切り記号を使用して、一度に複数のタグを追加できます。タグは、次の規則に準拠している必要があります。
- タグは 40 文字以下にする必要があります
- タグにスラッシュ (/) 文字または末尾にハイフン文字 (-) を含めることはできません。
- プロジェクトに追加できるタグは 15 個以下です
- タグでは大文字と小文字が区別されず、重複するタグや空のタグは使用できません。
Note

検索関数とフィルター関数を使用して、プロジェクトタグの検索やフィルター処理をすることはできません。
README ファイルを参照するか、プロジェクト Wiki ホームページを参照して、残りの要約ページの内容を参照するかどうかを選択します。

ヒント

既定の README は、プロジェクトの作成時に追加されたリポジトリ内に作成されます。この README を選択するか、この目的で別のリポジトリと README ファイルを作成できます。

[Readme ファイル] を選択した場合、README のリポジトリを選択します。 README ファイルの現在のテキストのプレビューが表示されます。

[Wiki] を選択した場合、Wiki ホームページが参照されます。これは、Wiki TOC 内の最初のファイルにする必要があります。その参照を変更することはできません。
参照先の README ファイルまたは wiki の内容を更新するには、対応するファイルを編集します。詳細については、「リポジトリの README を作成する」または「wiki ページを追加および編集する」を参照してください。

[要約] ページに次の種類の情報を含めることを検討してください。
- ユーザーがプロジェクトに貢献できる方法
- アクセス許可を昇格する、または拡張機能を追加する際の連絡先
- ロードマップ情報
- 開発環境とテスト環境を設定するための手順へのリンク
- コードでの共同作業、作業の追跡、パイプラインの構築、リリースのデプロイに関する手順へのリンク
- バグ、問題、または要求を提出するためのテンプレートへのリンク
- Slack または Teams チャネルに質問をメールで送信したり、質問を投稿したりするための配信リストへのリンク。

プロジェクトに共同作成者を招待する

[招待] を選択して、プロジェクトを共同作成するようユーザーを招待するメールを送信します。詳細については、「ユーザーまたはグループをチームまたはプロジェクトに追加する、要約ページからユーザーを招待する」を参照してください。

[要約] ページ、[招待] ボタンのスクリーンショット。

Note

Azure DevOps Server の場合、すべてのメールアクションで SMTP サーバーを構成する必要があります。

プロジェクトアクティビティを表示する

[プロジェクト統計] または [アクティビティ] セクションから、過去 1 日間、7 日間、または 30 日間にプロジェクトに対して行われた更新を表示できます。次の画像に示すように、表示オプションを選択します。

[要約] ページの [統計] セクションのスクリーンショット。

プロジェクトメンバーとチャットするか、メールを送信する

[メンバー] セクションでは、プロジェクトに追加されたメンバーの一部を確認し、メールまたはメンバーとのチャットを介してメンバーとつながることができます。

[要約] ページの [メンバー] セクションのスクリーンショット。

Note

100 以上は、100 以上のメンバーがプロジェクトに追加されることを示します。

チャットセッションをメールで送信または開始するには、表示されているチームメンバーを選択し、オプションを選択します。

[要約] ページ、[メンバー] セクション、チームメンバーとつながるために使用できるオプションのスクリーンショット。

Note

オンプレミスの Azure DevOps の場合、すべての電子メールアクションで SMTP サーバーを構成する必要があります。

プロジェクトを検索する

[要約] ページから、コード、作業項目、Wiki の検索を開始できます。詳細については、「AzCopy の概要」を参照してください。

Git リポジトリの README ファイルを初期化する

プロジェクトと目標、チームメンバーがプロジェクト README ファイルを使用してプロジェクトを共同作成する方法を共有できます。 Git プロジェクトの場合、README.md ファイルは、既定のブランチ内の各リポジトリのルートにある必要があります。 Git ベースのプロジェクトの場合、左側のウィンドウでは他のリポジトリへのナビゲーションがサポートされています。リポジトリごとに個別のウェルカムページと README.md ファイルを作成できます。

[リポジトリ]>[ファイル] を開きます。このページでは、リポジトリのクローン、プッシュ、インポート、初期化のいずれかのオプションを選択するときに、リポジトリにコードを追加して、すぐに作業を開始する方法について説明します。
[README を追加する] のチェックボックスをオンにして、[初期化] を選択します。

既定の README ファイルがプロジェクトリポジトリ (この場合は Fabrikam Test リポジトリ) に追加されます。
[概要]>[要約] に戻り、プロジェクトページの README ファイルを選択します。 [編集] を選択します。
README ファイルを初期化したプロジェクトリポジトリを選択します。
README ファイルを編集するには、README ファイルのリンクを選択します。

README ファイルの [リポジトリ]>[ファイル] ページに移動します。 README Markdown ファイルは、Git リポジトリ内の他のファイルと同様に編集および変更できます。 Markdown 言語を使用して README ファイルの書式を設定し、画像を追加できます。詳細については、「リポジトリの README を作成する」と「Markdown ガイダンス」を参照してください。