リリース ノートを作成する

Jira には、プロジェクトの特定バージョンに対するリリース ノートを作成する機能があります。リリース ノートには、特定の「修正」バージョンとマークされた、指定したプロジェクト内のすべての課題が含まれます。また、リリース ノートを多数の形式 (プレーン テキストなど) で生成して、さまざまなドキュメントに含められます。

現在のところ、Verocity テンプレートを使用した、HTML とテキストの 2 つの書式設定テンプレートが提供されています。これ以外にも、書式設定テンプレートを作成してシステムに追加できます。

リリースノートの生成

1. ナビゲーションバーで「プロジェクト」を選択します。
2. リストからプロジェクトを選択するか、「すべてのプロジェクトを表示」を選択してプロジェクトに移動します。
3. Select Versions in the project sidebar (if you're using Jira Software, select Releases in the project sidebar).
4. リリースノートを生成する「バージョン」をクリックして選択します。
5. リリースノートを選択します。
6. 「リリースノートの構成」リンクをクリックしてリリースノートを構成します。「リリースノートの構成」ページが表示されます。
   
   • 「バージョンを選択してください」ドロップダウンからリリースノートを生成するために必要なプロジェクトのバージョンを選択します。
   • リリース ノートに必要な形式を選択します。プレーン テキスト形式のテンプレートは [スタイルを選択してください] ドロップダウンに用意されています。
7. 「作成」ボタンを選択すると、指定した形式の指定したテンプレートによってリリース ノートを生成します。リリース ノートが画面に表示されて、別のアプリケーションにコピー & ペーストできます。

新しい書式設定テンプレートの追加

1. 例として提供された releasenotes-text.vm および releasenotes-html.vm に似た内容の Velocity テンプレートを作成します。Jira API ドキュメントおよび Apache Velocity ユーザー ガイドを参照してください。
2. テキスト エリア内のコードとともに、テンプレート内のタイトルを変更する必要があります。テンプレートの他のセクションは変更不要です。
3. 新しい書式設定テンプレートを、jira-config.properties ファイルにある既存のテンプレートの一覧に追加します。それぞれの新しいテンプレート形式について、次のプロパティの既存の値に対応する値を追加する必要があります。
   
   • jira.releasenotes.templatenames

   • jira.releasenotes.templates

     注意:

     • これらのプロパティの対応するエントリは同じ順序にする必要があります。
     • これらのプロパティが jira-config.properties ファイルに存在しない場合、次のようにします。
       1. これらの各プロパティに対してプロパティ名を追加します。
       2. 「=」と続けます。
       3. 続けて、Jira インストールの jpm.xml ファイルからコピーした、プロパティに対応する <default-value/> 要素の内容を入力します。
       4. 次に、新しい書式設定テンプレートに対応するエントリの追加を開始します。

     詳細は「jira-config.properties ファイルに変更を加える」をご参照ください。

   
   

4. 新しい書式設定テンプレートを、リリースノート書式設定テンプレートとして選択できます。

また「リリース コメントを含むカスタムのリリース ノート テンプレートを作成」のチュートリアルをご参照ください。