ブログを活用して開発チームの進捗状況を共有する方法
開発チームで最も大変な作業の 1 つは、チームや組織の全員が常に最新情報を把握できるようにすることです。ある人は「プロジェクト X」のステータスを、他の人はどのような新機能がいつ公開されるのかを知りたいと思います。次の四半期の予定に興味がある人もいます。多くのチームは大規模な会議や大量のメールに大きく依存していますが、透明性や可視性といった点において、これらの選択肢は効果的ではありません。メールを見逃すことも、メールが埋もれてしまうこともあります。大きなアナウンスがあった後に、その内容を参照する方法も、シンプルな質問方法もない場合があります。
このようなケースには、Confluence のブログ投稿を活用できます。この記事では、ブログ投稿を活用して、開発チームやより大きな組織全体で重要な情報や更新を共有する方法を紹介します。ブログは、チームメイトや同僚に最新情報を伝えることができる優れたツールです。ブログ投稿は、メール ボックスの中に埋もれてしまうことがなく、Jira 課題やマクロなどの動的なコンテンツを使用して作成できます。また、長大なメール スレッドに取り組むことなく、興味を持ったステークホルダーと簡単にやり取りを始めることができます。アトラシアンで公開している Confluence の 3 つのブログをご紹介します。
ブログ 1: プロジェクトおよびリリースの更新
アトラシアンでは、新しいリリースを顧客に公開する前に、開発チームのメンバーが Confluence で社内ブログ投稿を作成し、アトラシアン社員にリリース内容を伝えています。開発者は、どの機能が公開され、製品にどのような変更が加えられたかを把握する必要があります。これは、全員が最新情報を把握できるようにする、最も簡単で効率的な方法です。
どの機能が公開されたかを示す最も簡単な方法は、Confluence ページ内に 1 つの課題または課題リストを埋め込む Jira 課題マクロを使用して、Jira から課題を取得する方法です。埋め込まれた課題は動的な情報になるため、課題をクリックして Jira にアクセスし、公開内容の詳細を確認できます。
JIRA の課題マクロでできること :
- JIRA クエリ言語 (JQL) を利用した検索結果に基づき、ページ上に Jira 課題テーブルを表示する。
- Jira の URL を使用して、ページ上に Jira 課題の表を表示する。
- JIRA のサイトから単一の課題を表示する、または、JIRA のサーチ結果から選択された課題のサブセットを表示する
- JIRA サイトの課題数を表示する
- Confluence にアクセスしたまま、ページで Jira に新しい課題を作成し、表示する。
Jira を Confluence ページに取り込む強力なマクロです。マクロを構成し、Jira から取り込みたい課題を検索する方法について、以降で説明します。
プロのヒント: JIRA クエリ言語 (JQL) を使用して課題を表示する
また、マクロを使用し、JIRA クエリ言語 (JQL) を使用した検索結果に基づいて、ページ上に Jira 課題の表を表示することもできます。
JQL は、Jira で使用できる、SQL に似たシンプルなクエリ言語です。基本的な JQL のクエリは、フィールド、演算子 (= や > など)、1 つ以上の値または関数の順に構成されます。
例:
- 次のクエリは、 プロジェクト内のすべての課題を検索します。
project = "TEST"
- 次のクエリは、'CONF' プロジェクトの 'documentation' コンポーネント内のすべての課題を検索します。
project = CONF and component = documentation
JQL の構文の詳細については、Jira ドキュメント「高度な検索」を参照してください。
アトラシアンのリリース ブログの多くは非常にシンプルです。Jira 課題マクロは、最新の製品リリースに関する最新情報をすばやく作成できる、優れた方法です。ただし、gif や面白い動画、HipChat の顔文字や長い冗談が詰まった、昔ながらのシンプルで楽しいリリース ブログを投稿することもあります。下記は、「EAC」と呼ばれるアトラシアンの Confluence インスタンスで、新機能の試験運用についてアトラシアンのメンバーに知らせるために Confluence のテクニカル ライターが公開したブログ投稿です。
ブログを楽しく気軽な雰囲気にすることは、チームや組織とのエンゲージメントを促進する優れた方法です。画面の右側では、投稿を支持するすべてのインライン コメントを確認できます。
ブログ 2: チームと知識を共有する
アトラシアンの開発チームは、技術的に困難な問題を支援したり、それらの解決方法をシェアしたりするために、定期的にブログを投稿します。Confluence でコードについて記述する最適な方法の 1 つは、コード ブロック マクロを使用することです。
コード ブロック マクロを使用すると、適切なシンタックス ハイライトでソース コードをページに表示できます。さまざまなシンタックスやテーマから選択して Confluence でコードを表示することができます。
マクロをページに追加するには、エディター ツールバーで「挿入」メニューをクリックし、「その他のマクロ」を選択します。マクロ ブラウザーが起動し、「コード ブロック」を検索して選択できます。完了したら、さまざまなフィールドを設定できます。
アトラシアンのイントラネットから、コード ブロック マクロの使用方法を示しているブログ投稿の例を紹介します。
プロのヒント: オートコンプリートでマクロ入力をスピードアップする
「{」と入力してからマクロ名を入力することで、候補のマクロのリストを表示します。
ブログ 3: 新入社員の紹介
新入社員が円滑に業務を開始できるようにすることは重要です。アトラシアンでは、すべての従業員が Confluence で自己紹介のブログ投稿を作成します。これは、新しいメンバーが自分自身を組織全体へ紹介したり、Confluence や組織に慣れたりするのに最適な方法です。アトラシアン社員はコメントを追加して新入社員を歓迎します。Confluence を使って大規模な組織で行う、非常にポジティブな最初のやり取りです。
自己紹介のブログ投稿を作成するにはいくつかのポイントがあります。
タイトルを工夫する
自己紹介のブログ投稿を他の人に見てもらいたい場合、タイトルを工夫しましょう。いくつか例を挙げます。
- Ryan Anderson はアトラシアンの求人に応募しました。すると...
- Ryan Anderson™ を正常にインストールしました
- 新しいキャラクター(文字)が作成されました: Ryan Anderson
ページ レイアウトを使用してブログ投稿を整理する
ページ レイアウトを使用してブログ投稿をセクションや列に整理します。ページ レイアウトで作業するためページ レイアウトで作業するためのヒントは、「セクションの追加」ボタンを数回クリックし、作業するブロックを複数用意することです。次に、ページを構築しながら、さまざまな列の配置を選択できます。これらは後からいつでも切り替えることができます。
多くの画像を使用する
旅行や好きな食べ物、趣味、家族などの素敵な写真を使い、良い第一印象を与えましょう。Confluence では、ドラッグ アンド ドロップで簡単に画像を追加できます。ハード ドライブから 1 つ (または複数) の画像をドラッグして、Confluence エディターにドロップするだけです。Confluence はページに画像を添付してインラインに配置します。その後、画像をクリックし、ページ内の任意の場所にドラッグして配置できます。
プロのヒント: 画像にスタイルを設定する
ページの編集中に、画像を選択し、画像のプロパティ パネルを開きます。パネルでは、表示サイズの設定、枠線や効果の追加、他のページへのリンクなど、イメージの外観を変更できます。
「プロパティ」ボタンをクリックすると、インスタント カメラ、ドロップ シャドウ、または影効果などの効果を画像に加えることができます。
すべてが完了すると、チームと共有するために最適な、次のような美しいブログ投稿ができるでしょう。
At a glance: what did you just learn?
ブログ投稿を使用すると、アナウンスや状況報告を提供し、その他のタイムリーな情報を簡単に共有できます。この記事で学習した内容をチームで実行して、開発チームやさらに大きな組織でのチームワーク向上に役立つブログ文化を始めましょう。ここで説明した内容は次のとおりです。
- Jira 課題マクロ: Jira の課題を Confluence のページに取り込みます。
- コード ブロック マクロ: Confluence ページでソース コードを表示します。
- ページ レイアウト: さまざまな列レイアウトでブログ投稿を整理します。
- 画像の追加: 画像またはファイルを Confluence ページに追加する一番早い方法はドラッグ アンド ドロップです。
- 画像効果: 画像に効果を追加して、より目立たせることができます。
この内容はお役に立ちましたか? 素晴らしいブログ投稿を作成できたなら、@Confluence にスクリーンショットをツイートしてプレゼントに応募しましょう!
Hungry for more?
Confluence を使用するためのあらゆるヒントを、Confluence を使用するソフトウェア チームのためのガイド ebook をダウンロードしてご確認いただけます。また、このような記事が投稿されたときに通知を受け取るには、このスペースでブログをウォッチしてください。さらに興味がある場合、Confluence に関するすべての情報を網羅する月間ニュースレター、Confluence Insiders へ登録してください。
このページはお役に立ちましたか? Twitter でシェアしてください。










