YouTrackとナレッジベース

こんにちは、ハブル!

JetBrainsの接続されたYoutrackチーム。ユーザーから長い間、ドキュメントをトラッカーに直接保存できるようにするための工夫が求められてきました。そして、2020.2のメジャーリリースの一環として、重要なイベントが発生しました。ナレッジベースがYouTrackに登場しました。役立つ情報を収集して1か所で作業し、内部ドキュメントをプロジェクトやタスクと並べてYouTrackに直接保存できるようになりました。外部ユーザーはトラッカーで直接質問への回答を見つけることができます。

画像

詳細については、投稿へようこそ。

それは何ですか?


私たちは自転車を発明しませんでした:私たちの知識ベースは記事のコレクションです。記事はツリー構造に編成され、そのルートはプロジェクトです。したがって、各プロジェクトは分岐した記事構造を持つことができます。

画像

簡潔にするのが好きな人のために、ナレッジベースの主な機能を以下にリストします。また、スクリプトや写真を見ることに興味がある人は、さらに歓迎します。

したがって、実際に記事を作成することに加えて、次のことができます
。1.全文検索を使用して、目的の記事を検索します。
2. WYSIWYGまたはMarkdownエディターを使用します。
3.テーブル、チェックリスト、順序付きリストを使用してさまざまなコンテンツを作成し、YouTubeビデオからGoogleドキュメントまで、さまざまなメディアを添付または埋め込みます。
4.コメントで記事について話し合い、同僚やタスクについて言及します。
5.興味のある記事の変更およびコメントの通知をサブスクライブします。
6.記事の以前のバージョンを表示し、必要に応じて以前のバージョンを復元します。
7.役割を使用して記事へのアクセスを管理し(プロジェクトレベルで記事へのアクセスを制御する適切な権限を追加しました)、タスクと同様に、表示リストを使用して個々の記事(または記事のブランチ全体)の表示を制限します。

OK、そしてそれについて何をすべきか?


ユーザーの経験によると、ナレッジベースを使用する最も一般的なシナリオは2つあります。内部チームのドキュメント(ミーティングノート、休暇スケジュール、内部ガイド)と外部ユーザー向けのパブリックナレッジベース(よくある質問、製品ドキュメント、ロードマップ)です。

チームの内部ドキュメント


会議のメモ、新しいチームメンバーのチェックリスト、VPNのセットアップ手順など、ドキュメントがない現代のチームを想像するのは困難です。 YouTrackナレッジベースは、すべてを1か所に集めるのに役立ちます。もちろん、開発チームだけでなく便利です。
あなたが同僚のためにチームビルディングを組織するとします。イベントを計画するには、ナレッジベースで記事を作成し、そこにアイデアを書き留めます。 YouTrackは自動的にドラフトを保存し、いつでもそれに戻ることができます。

記事のタイトルの上にあるドロップダウンメニューで、記事を誰に表示するかを指定します。タスクを操作するときと同じように、記事階層内の個々のドキュメントとブランチへのアクセスを制限できます。デフォルトでは、記事はプロジェクトで「記事を読む」権限を持つすべてのユーザーが利用できますが、この表示はいつでも狭めることができます。可視性の設定はナレッジベース階層を下に伝搬するため、添付された記事は上流の記事と同じユーザーに表示されます。

画像

フルテキストを読むのは簡単ではありません-ここで私たちのエディターの機能が役に立ちます。たとえば、昨年の夏にチームビルディングがビデオでどのようにうまくいったかを同僚に思い出させるか、表、チェックリスト、順序付きリストを使用してコンテンツを構成します。



そして、記事の公開後、同僚にあなたのアイデアを議論するように誘う時が来ました-言及メカニズムはタスクと同じように機能します。心配しないでください、あなたは何も見逃しません-コメントについての通知が来るでしょう。別の著者の記事で何が起こっているかを追跡したい場合は、アスタリスクでマークするだけで、それに関する通知も受け取ります。

ユーザーのためのオープンな知識ベース


ナレッジベースには、ドキュメントとロードマップだけでなく、便利な情報が格納されています。ユーザーが製品の使用について質問する場合があります。よくある質問への回答と使用ガイドを1か所に集めて公開することは、ユーザーの生活を快適にする優れた方法です。

最初に匿名アクセスを許可します。外部ユーザーが登録せずにナレッジベースに入ることができるように、YouTrackサーバーに。アクセス制御は非常に柔軟です。特定のサークルの人々(チーム、登録ユーザー、または全員)に対して個別の記事ブランチを開くことができます。今、あなたはあなたの知識ベースを満たす必要があります!記事を書いたり、表を追加したり、ファイルを添付したり、編集を恐れないでください。記事のすべてのバージョンは[履歴]タブで利用でき、いつでもバージョン間の違いを確認して、以前の状態にロールバックできます。

画像

記事へのコメントで顧客の質問に答え、更新の通知を受け取り、タスクディスカッションでナレッジベースから記事にリンクします。同僚の助けが必要な場合はコメントで同僚に言及し、関連する記事やタスクへのリンクを投稿してください-必要な情報はすべてすぐに利用できます。

ナレッジベース検索


オープンナレッジベースとクローズドナレッジベースの両方で、フルテキスト検索が機能し、検索された単語または語句を含むすべての記事が検索されます。検索結果から適切な記事に移動して、質問に対する答えを見つけるのは簡単です。

画像

JetBrainsでこれを使用しますか?


YouTrackチームにはルールがあります。私たちは常に自分たちのために製品の重要な変更を実行します。知識ベースも例外ではありませんでした。たとえば、毎週の会議の記録を数か月間保管し、内部ドキュメントのセクション全体を作成しました。新しいテクニカルサポートエンジニアのトレーニング計画、クラウドサーバーでスケジュールされた作業を実行するための指示、休暇を取るための推奨事項を見つけることができます。

画像

多くの機能と修正が私たちの経験の結果として正確に実装されました:レイアウト上で便利に見えたものは使い心地が悪いことが判明したか、一部の機能が欠けていると感じました。そして、このジャンルのクラシックがリリースされる前の夜に、私たちはかなり深刻なバグを見つけ、チームの共同作業でそれをなんとか修正しました。

他に興味深いことはありますか?


もちろん、ナレッジベースはYouTrack 2020.2の唯一の改善ではありません。

プロジェクト管理者は、デフォルトでプロジェクトのタスクを表示するユーザーのグループを設定できるようになりました。このシナリオでは、コードを記述する必要はありません。さらに、他のタイプに変換できるフィールドタイプのリストを拡張しました。たとえば、テキストフィールドを文字列フィールドに変換でき、ステータスフィールドを列挙型フィールドに変換して、いくつかのステータスフィールドの競合を回避できます。

他のチームの同僚との生産的な作業のために、タグ、保存された検索、アジャイルボード、およびレポートを、新しいより柔軟な方法で共有できます。つまり、一度に複数のユーザーグループと共有できます。

また、ワークスペースとタスクリストの新しい設定、およびアクション「ドラフトとしてタスクを複製」も追加しました。アジャイルのボードを使い始めたばかりの人のために、ボードを作成するプロセスをできるだけ簡略化しました。すべてのイノベーションについて詳しくは、ブログをご覧ください

All Articles