SlideShare a Scribd company logo
1 of 26
Download to read offline
Copyright (C) 2020 Yahoo Japan Corporation. All Rights Reserved.
©2021 Yahoo Japan Corporation All rights reserved.
Yahoo! ニュースにおける
ドキュメント管理の事例紹介
ヤフー株式会社 メディア統括本部 ニュース担当 後藤拓実
©2021 Yahoo Japan Corporation All rights reserved.
⾃⼰紹介
2
•2012年にヤフー株式会社へ新卒⼊社
フロントエンド寄りのエンジニア
• ニュースサービス担当10年⽬
• 2018年頃から技術刷新プロジェクトに携わる
現在は ウェブ版 Yahoo! ニュースのテックリードを担当
©2021 Yahoo Japan Corporation All rights reserved.
今⽇お話すること
3
シンプルなガイドラインを敷くことでドキュメントの改善が進んだ
• Yahoo!ニュースにおけるドキュメントの課題
• 改善に向けて策定したガイドラインの紹介
©2021 Yahoo Japan Corporation All rights reserved.
ヤフーにおけるドキュメント管理事情
4
•全社員で1つのコンフルエンスを利⽤
• 2006年に導⼊ 15年以上稼働
• 利⽤⽤途に縛りはなく⾃由に使える
• 組織、プロダクト、プロジェクト、個⼈等の様々な単位
• メモ書きから⼿順書、議事録、組織情報など
©2021 Yahoo Japan Corporation All rights reserved.
Yahoo! ニュースの組織
5
• 全職種含めておよそ200⼈
• プロジェクトやプロダクト等の数⼗のチーム
• 表向き1サービスだが異なる組織の合流の歴史
そんな中、以下のようにコンフルエンスが使われていた
• 基本的に1つのスペース配下に全チームのドキュメントを集約
• チームかシステム毎にポータル的なページがあり、
そのページ配下に関連する⽂書を⾃由に作っていく
©2021 Yahoo Japan Corporation All rights reserved.
ドキュメントに関しての2018年頃の課題感
6
• スペース直下やチーム毎のページ直下にどんどんページが追加される
• チーム内外問わず階層構造や⾒出しが整理されていない・統⼀感がない
その結果、
• 辿りづらいのでブックマークしたり、⾃分⽤のリンク集を作ったりしがち
• 資料が⼀時的な情報なのか、最新の情報なのか分かりづらい
• ドキュメントを探す範囲が広くなりがちで時間を無駄にしてしまう
• 整理されている感じがしないため探すときの⼼理的ハードルが⾮常に⾼い
©2021 Yahoo Japan Corporation All rights reserved.
なぜこうなるのか
7
•広く適⽤できるような明⽂化された管理の⽅針がなかった
• サービス内の組織横断で統⼀を働きかける機会がなかった
• 致命的なボトルネックではないので問題とならなかった
©2021 Yahoo Japan Corporation All rights reserved.
改善に向けての取り組み
8
• ドキュメント管理のガイドラインを作成
• 2018年頃からの技術刷新の取り組みに合わせて適⽤
©2021 Yahoo Japan Corporation All rights reserved.
どのようなガイドラインか
9
構造と⾒出しについてのシンプルなルール
① ページを3種のページ種別から構成する
• ページの種類はポータル、リスト、コンテンツの3つ
② ページ⾒出しの命名規則を守る
©2021 Yahoo Japan Corporation All rights reserved.
①3つのページ種別
10
ポータルページ
ファーストビューを重視した配下ページへのハブとなるページ
リストページ
コンテンツページをリスト化するためのページ
コンテンツページ
実際に作業記録や議事録等の資料を書くページ
©2021 Yahoo Japan Corporation All rights reserved.
3つのページ種別による階層下の例
11
©2021 Yahoo Japan Corporation All rights reserved.
3つのページ種別による階層下の例
12
©2021 Yahoo Japan Corporation All rights reserved.
ポータルページ
13
作成単位
• プロダクトやプロジェクト、案件といった任意の単位で作成
• ポータルの直下にポータルを設置することも可能
ページ内容
• 概要情報や配下のドキュメントを⾒つけやすくするためのページ。
• ポータルとしての機能が重要なので⾒やすさを優先して⾃由に構成して良い
• ポータルの直下はリストかポータル
©2021 Yahoo Japan Corporation All rights reserved.
ポータルページの画⾯構成の例
14
©2021 Yahoo Japan Corporation All rights reserved.
リストページ
15
主にコンテンツページをまとめる階層を作るページ
作成単位
• コンテンツページの種類ごと(議事録、作業記録、⼿順書、設計書など)
内容
•⼦ページマクロ等を使い、配下にあるコンテンツページを⼀覧にしておくと良い
• リストの直下はコンテンツページに限らず、同様なものが並んでいれば良い。
例えば、プロジェクトのポータルページが並ぶようなパターンもあり得る
©2021 Yahoo Japan Corporation All rights reserved.
リストページの画⾯構成の例
16
©2021 Yahoo Japan Corporation All rights reserved.
コンテンツページ
17
基本的にフリーフォーマットだが、以下は必須
⽬次
• ⽂書の先頭で⽬次マクロを使い内容を俯瞰できるようにする
• ⾒出しはh1から順番に正しく使う
概要
• ページの概要を簡潔に書く
©2021 Yahoo Japan Corporation All rights reserved.
コンテンツページの画⾯構成の例
18
©2021 Yahoo Japan Corporation All rights reserved.
②ページ⾒出しの命名規則
19
基本
• 親ページの⾒出しに該当ページのタイトルを半⾓スペース区切りで繋げる
• ポータルページでは上記を無視して名称の階層をリセットして良い
⽇付
• ⼀時的なドキュメントには⽇付を⼊れる(次ページで補⾜)
• ⽇付のフォーマットはyyyy/mm/ddとする
©2021 Yahoo Japan Corporation All rights reserved.
⾒出しにおける⽇付の考え⽅
20
保守していく資料なのか⼀時的なものなのかどうかによって⽇付を⼊れる
保守しないページには⽇付を⼊れる
• 作業記録や議事録など、作成後に更新しないドキュメントが対象
• 作成する多くの資料は⼀時的なものであることが多い
保守していくページには⽇付を⼊れない
• 設計書や⼿順書など、ページを作成後も保守するドキュメントが対象
©2021 Yahoo Japan Corporation All rights reserved.
コンフルエンスのページ⾒出しの制約
21
同⼀スペース内で複数ページに同じタイトルは設定できない
ガイドラインでは親ページの名前を受け継ぐ命名にすることでこの制約を回避
NG OK
©2021 Yahoo Japan Corporation All rights reserved.
③⾒る⼈の⽴場になって書く
22
⽬次をつける
• ドキュメントの全体構成を俯瞰できるように
⾒出しレベルを正しく使う
• ⽬次をただしく出すためにh1から適切に使う
• スタイルを変えるために使わない(少し太字にしたいからh5を使うなど)
©2021 Yahoo Japan Corporation All rights reserved.
ガイドラインのポイント
23
シンプルなルール
•ガイドラインを知らなくてもパターンが想像でき⾒様⾒真似でルールを守れる
•こだわりが⽣まれやすいポイントの排除(⽇付フォーマット、区切り⽂字等)
リスト構造と命名規則によりパターンが⽣まれる
•パターンを認識できると整理されているように感じ、未知のドキュメントでも
探せる気になる。
©2021 Yahoo Japan Corporation All rights reserved.
ガイドラインの浸透と継続のTips
24
プロジェクト開始時などの最初に⼟台を作ってしまう
• 綺麗なところを汚そうとする⼈は少ない。⾒様⾒真似はしてくれる。
• 「作業記録」の置き場所をまず作ってしまう
定期的なガイドラインの共有
• 期初のキックオフ等の時にガイドラインを改めて共有する
• 新しく⼊社した⼈にも都度伝える
定期的なメンテナンス
• ガイドラインに沿ってないページを⾒つけたら適切な階層に移動・リネームする
©2021 Yahoo Japan Corporation All rights reserved.
ガイドライン作成後の現在(個⼈的な感想)
25
チームを超えてドキュメントに統⼀感が⽣まれてきている
• 技術刷新が進むに連れ複数のチームでドキュメントの改善が進んだ
• 想像がつくようになり他チームのドキュメントでも辿りやすくなった
どうあるべきか判断できるようになった
• 整理されてない無造作に作られたページは全てコンテンツページ
• 妥当なリストページ配下に移動してリネームすることで整理が進む
©2021 Yahoo Japan Corporation All rights reserved.
EOP
26

More Related Content

What's hot

What's hot (20)

エンジニアの個人ブランディングと技術組織
エンジニアの個人ブランディングと技術組織エンジニアの個人ブランディングと技術組織
エンジニアの個人ブランディングと技術組織
 
ユーザーストーリー駆動開発で行こう。
ユーザーストーリー駆動開発で行こう。ユーザーストーリー駆動開発で行こう。
ユーザーストーリー駆動開発で行こう。
 
結果的に組織がAgileな状態であること #agile #scrum #leanstartup
結果的に組織がAgileな状態であること #agile #scrum #leanstartup結果的に組織がAgileな状態であること #agile #scrum #leanstartup
結果的に組織がAgileな状態であること #agile #scrum #leanstartup
 
モノタロウECプラットフォームを支える開発運用モダナイゼーションの取り組み #devsumi
モノタロウECプラットフォームを支える開発運用モダナイゼーションの取り組み #devsumi モノタロウECプラットフォームを支える開発運用モダナイゼーションの取り組み #devsumi
モノタロウECプラットフォームを支える開発運用モダナイゼーションの取り組み #devsumi
 
事業成長にコミットするエンジニア組織への道のり
事業成長にコミットするエンジニア組織への道のり事業成長にコミットするエンジニア組織への道のり
事業成長にコミットするエンジニア組織への道のり
 
ヤフーのプライベートクラウドとクラウドエンジニアの業務について
ヤフーのプライベートクラウドとクラウドエンジニアの業務についてヤフーのプライベートクラウドとクラウドエンジニアの業務について
ヤフーのプライベートクラウドとクラウドエンジニアの業務について
 
分散システムの限界について知ろう
分散システムの限界について知ろう分散システムの限界について知ろう
分散システムの限界について知ろう
 
45分間で「ユーザー中心のものづくり」ができるまで詰め込む
45分間で「ユーザー中心のものづくり」ができるまで詰め込む45分間で「ユーザー中心のものづくり」ができるまで詰め込む
45分間で「ユーザー中心のものづくり」ができるまで詰め込む
 
アジャイル開発とメトリクス
アジャイル開発とメトリクスアジャイル開発とメトリクス
アジャイル開発とメトリクス
 
Unityではじめるオープンワールド制作 エンジニア編
Unityではじめるオープンワールド制作 エンジニア編Unityではじめるオープンワールド制作 エンジニア編
Unityではじめるオープンワールド制作 エンジニア編
 
シリコンバレーの「何が」凄いのか
シリコンバレーの「何が」凄いのかシリコンバレーの「何が」凄いのか
シリコンバレーの「何が」凄いのか
 
Apache Sparkに手を出してヤケドしないための基本 ~「Apache Spark入門より」~ (デブサミ 2016 講演資料)
Apache Sparkに手を出してヤケドしないための基本 ~「Apache Spark入門より」~ (デブサミ 2016 講演資料)Apache Sparkに手を出してヤケドしないための基本 ~「Apache Spark入門より」~ (デブサミ 2016 講演資料)
Apache Sparkに手を出してヤケドしないための基本 ~「Apache Spark入門より」~ (デブサミ 2016 講演資料)
 
見よう見まねでやってみる2D流体シミュレーション
見よう見まねでやってみる2D流体シミュレーション見よう見まねでやってみる2D流体シミュレーション
見よう見まねでやってみる2D流体シミュレーション
 
Qiita Night 足場固めからやるマイクロサービス
Qiita Night 足場固めからやるマイクロサービスQiita Night 足場固めからやるマイクロサービス
Qiita Night 足場固めからやるマイクロサービス
 
エンジニアから飛んでくるマサカリを受け止める心得
エンジニアから飛んでくるマサカリを受け止める心得エンジニアから飛んでくるマサカリを受け止める心得
エンジニアから飛んでくるマサカリを受け止める心得
 
ホットペッパービューティーにおけるモバイルアプリ向けAPIのBFF/Backend分割
ホットペッパービューティーにおけるモバイルアプリ向けAPIのBFF/Backend分割ホットペッパービューティーにおけるモバイルアプリ向けAPIのBFF/Backend分割
ホットペッパービューティーにおけるモバイルアプリ向けAPIのBFF/Backend分割
 
営業さんまで、社員全員がSQLを使う 「越境型組織」 ができるまでの3+1のポイント | リブセンス
営業さんまで、社員全員がSQLを使う 「越境型組織」 ができるまでの3+1のポイント | リブセンス営業さんまで、社員全員がSQLを使う 「越境型組織」 ができるまでの3+1のポイント | リブセンス
営業さんまで、社員全員がSQLを使う 「越境型組織」 ができるまでの3+1のポイント | リブセンス
 
Test Yourself - テストを書くと何がどう変わるか
Test Yourself - テストを書くと何がどう変わるかTest Yourself - テストを書くと何がどう変わるか
Test Yourself - テストを書くと何がどう変わるか
 
見やすいプレゼン資料の作り方 - リニューアル増量版
見やすいプレゼン資料の作り方 - リニューアル増量版見やすいプレゼン資料の作り方 - リニューアル増量版
見やすいプレゼン資料の作り方 - リニューアル増量版
 
ペアプログラミング ホントのところ
ペアプログラミング ホントのところペアプログラミング ホントのところ
ペアプログラミング ホントのところ
 

Similar to Yahoo! ニュースにおける ドキュメント管理の事例紹介

B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...
B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...
B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...
日本マイクロソフト株式会社
 
[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例
[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例
[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例
de:code 2017
 

Similar to Yahoo! ニュースにおける ドキュメント管理の事例紹介 (20)

11年モノのテックブログを引き継いでから始めたこと、続けたこと、やめたこと
11年モノのテックブログを引き継いでから始めたこと、続けたこと、やめたこと11年モノのテックブログを引き継いでから始めたこと、続けたこと、やめたこと
11年モノのテックブログを引き継いでから始めたこと、続けたこと、やめたこと
 
[XP祭り2021]アナログ事業会社のデジタル推進戦略
[XP祭り2021]アナログ事業会社のデジタル推進戦略[XP祭り2021]アナログ事業会社のデジタル推進戦略
[XP祭り2021]アナログ事業会社のデジタル推進戦略
 
アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.01
アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.01アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.01
アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.01
 
アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.04
アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.04アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.04
アフターコロナ、ウィズコロナに備えるための 経営を "リデザイン" するオンラインセミナー vol.04
 
How to create android's c to c EC APP !
How to create android's c to c EC APP !How to create android's c to c EC APP !
How to create android's c to c EC APP !
 
やってみよう!ユーザーテスト
やってみよう!ユーザーテストやってみよう!ユーザーテスト
やってみよう!ユーザーテスト
 
A2-6 現場発!メールサービスを支える運用者の集い 2021 秋(ヤフー 中村氏)
A2-6 現場発!メールサービスを支える運用者の集い 2021 秋(ヤフー 中村氏)A2-6 現場発!メールサービスを支える運用者の集い 2021 秋(ヤフー 中村氏)
A2-6 現場発!メールサービスを支える運用者の集い 2021 秋(ヤフー 中村氏)
 
サイボウズの生産性を高める生産性向上チームと開発文化
サイボウズの生産性を高める生産性向上チームと開発文化サイボウズの生産性を高める生産性向上チームと開発文化
サイボウズの生産性を高める生産性向上チームと開発文化
 
For reader
For readerFor reader
For reader
 
JaSST Tokyo 2022 アジャイルソフトウェア開発への統計的品質管理の応用
JaSST Tokyo 2022 アジャイルソフトウェア開発への統計的品質管理の応用JaSST Tokyo 2022 アジャイルソフトウェア開発への統計的品質管理の応用
JaSST Tokyo 2022 アジャイルソフトウェア開発への統計的品質管理の応用
 
B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...
B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...
B13_株式会社資生堂 プロフェッショナル事業の日本とタイの基幹系業務を「 Microsoft Dynamics 365 」で統合管理 [Microsof...
 
サイボウズ超会議「B2Bマーケティング編」
サイボウズ超会議「B2Bマーケティング編」サイボウズ超会議「B2Bマーケティング編」
サイボウズ超会議「B2Bマーケティング編」
 
20220319_新卒から活躍し続けるエンジニアが大切にしている5つのこと
20220319_新卒から活躍し続けるエンジニアが大切にしている5つのこと20220319_新卒から活躍し続けるエンジニアが大切にしている5つのこと
20220319_新卒から活躍し続けるエンジニアが大切にしている5つのこと
 
クラスメソッドベトナム設立しました
クラスメソッドベトナム設立しましたクラスメソッドベトナム設立しました
クラスメソッドベトナム設立しました
 
非IT企業がWEBサービスやアプリを 新規開発するときの課題と解決方法 〜開発編〜
非IT企業がWEBサービスやアプリを 新規開発するときの課題と解決方法  〜開発編〜非IT企業がWEBサービスやアプリを 新規開発するときの課題と解決方法  〜開発編〜
非IT企業がWEBサービスやアプリを 新規開発するときの課題と解決方法 〜開発編〜
 
Notes/Domino 開発tipsサービスについて
Notes/Domino 開発tipsサービスについてNotes/Domino 開発tipsサービスについて
Notes/Domino 開発tipsサービスについて
 
PayPayのスピード×ビジネス×デザイン
PayPayのスピード×ビジネス×デザインPayPayのスピード×ビジネス×デザイン
PayPayのスピード×ビジネス×デザイン
 
サイエンス視点からのデータアーキテクト
サイエンス視点からのデータアーキテクトサイエンス視点からのデータアーキテクト
サイエンス視点からのデータアーキテクト
 
PDCA改善を積み上げるSeo手法紹介セミナー 清水資料 20130517_slideshare
PDCA改善を積み上げるSeo手法紹介セミナー 清水資料 20130517_slidesharePDCA改善を積み上げるSeo手法紹介セミナー 清水資料 20130517_slideshare
PDCA改善を積み上げるSeo手法紹介セミナー 清水資料 20130517_slideshare
 
[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例
[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例
[DO12] ナビタイムジャパン CTO 菊池氏が語る IT リーダのための開発を加速させる DevOps の実践例
 

More from Yahoo!デベロッパーネットワーク

More from Yahoo!デベロッパーネットワーク (20)

ゼロから始める転移学習
ゼロから始める転移学習ゼロから始める転移学習
ゼロから始める転移学習
 
継続的なモデルモニタリングを実現するKubernetes Operator
継続的なモデルモニタリングを実現するKubernetes Operator継続的なモデルモニタリングを実現するKubernetes Operator
継続的なモデルモニタリングを実現するKubernetes Operator
 
ヤフーでは開発迅速性と品質のバランスをどう取ってるか
ヤフーでは開発迅速性と品質のバランスをどう取ってるかヤフーでは開発迅速性と品質のバランスをどう取ってるか
ヤフーでは開発迅速性と品質のバランスをどう取ってるか
 
オンプレML基盤on Kubernetes パネルディスカッション
オンプレML基盤on Kubernetes パネルディスカッションオンプレML基盤on Kubernetes パネルディスカッション
オンプレML基盤on Kubernetes パネルディスカッション
 
LakeTahoe
LakeTahoeLakeTahoe
LakeTahoe
 
オンプレML基盤on Kubernetes 〜Yahoo! JAPAN AIPF〜
オンプレML基盤on Kubernetes 〜Yahoo! JAPAN AIPF〜オンプレML基盤on Kubernetes 〜Yahoo! JAPAN AIPF〜
オンプレML基盤on Kubernetes 〜Yahoo! JAPAN AIPF〜
 
Persistent-memory-native Database High-availability Feature
Persistent-memory-native Database High-availability FeaturePersistent-memory-native Database High-availability Feature
Persistent-memory-native Database High-availability Feature
 
データの価値を最大化させるためのデザイン~データビジュアライゼーションの方法~ #devsumi 17-E-2
データの価値を最大化させるためのデザイン~データビジュアライゼーションの方法~ #devsumi 17-E-2データの価値を最大化させるためのデザイン~データビジュアライゼーションの方法~ #devsumi 17-E-2
データの価値を最大化させるためのデザイン~データビジュアライゼーションの方法~ #devsumi 17-E-2
 
eコマースと実店舗の相互利益を目指したデザイン #yjtc
eコマースと実店舗の相互利益を目指したデザイン #yjtceコマースと実店舗の相互利益を目指したデザイン #yjtc
eコマースと実店舗の相互利益を目指したデザイン #yjtc
 
ヤフーを支えるセキュリティ ~サイバー攻撃を防ぐエンジニアの仕事とは~ #yjtc
ヤフーを支えるセキュリティ ~サイバー攻撃を防ぐエンジニアの仕事とは~ #yjtcヤフーを支えるセキュリティ ~サイバー攻撃を防ぐエンジニアの仕事とは~ #yjtc
ヤフーを支えるセキュリティ ~サイバー攻撃を防ぐエンジニアの仕事とは~ #yjtc
 
Yahoo! JAPANのIaaSを支えるKubernetesクラスタ、アップデート自動化への挑戦 #yjtc
Yahoo! JAPANのIaaSを支えるKubernetesクラスタ、アップデート自動化への挑戦 #yjtcYahoo! JAPANのIaaSを支えるKubernetesクラスタ、アップデート自動化への挑戦 #yjtc
Yahoo! JAPANのIaaSを支えるKubernetesクラスタ、アップデート自動化への挑戦 #yjtc
 
ビッグデータから人々のムードを捉える #yjtc
ビッグデータから人々のムードを捉える #yjtcビッグデータから人々のムードを捉える #yjtc
ビッグデータから人々のムードを捉える #yjtc
 
サイエンス領域におけるMLOpsの取り組み #yjtc
サイエンス領域におけるMLOpsの取り組み #yjtcサイエンス領域におけるMLOpsの取り組み #yjtc
サイエンス領域におけるMLOpsの取り組み #yjtc
 
ヤフーのAIプラットフォーム紹介 ~AIテックカンパニーを支えるデータ基盤~ #yjtc
ヤフーのAIプラットフォーム紹介 ~AIテックカンパニーを支えるデータ基盤~ #yjtcヤフーのAIプラットフォーム紹介 ~AIテックカンパニーを支えるデータ基盤~ #yjtc
ヤフーのAIプラットフォーム紹介 ~AIテックカンパニーを支えるデータ基盤~ #yjtc
 
Yahoo! JAPAN Tech Conference 2022 Day2 Keynote #yjtc
Yahoo! JAPAN Tech Conference 2022 Day2 Keynote #yjtcYahoo! JAPAN Tech Conference 2022 Day2 Keynote #yjtc
Yahoo! JAPAN Tech Conference 2022 Day2 Keynote #yjtc
 
新技術を使った次世代の商品の見せ方 ~ヤフオク!のマルチビュー機能~ #yjtc
新技術を使った次世代の商品の見せ方 ~ヤフオク!のマルチビュー機能~ #yjtc新技術を使った次世代の商品の見せ方 ~ヤフオク!のマルチビュー機能~ #yjtc
新技術を使った次世代の商品の見せ方 ~ヤフオク!のマルチビュー機能~ #yjtc
 
PC版Yahoo!メールリニューアル ~サービスのUI/UX統合と改善プロセス~ #yjtc
PC版Yahoo!メールリニューアル ~サービスのUI/UX統合と改善プロセス~ #yjtcPC版Yahoo!メールリニューアル ~サービスのUI/UX統合と改善プロセス~ #yjtc
PC版Yahoo!メールリニューアル ~サービスのUI/UX統合と改善プロセス~ #yjtc
 
モブデザインによる多職種チームのコミュニケーション改善 #yjtc
モブデザインによる多職種チームのコミュニケーション改善 #yjtcモブデザインによる多職種チームのコミュニケーション改善 #yjtc
モブデザインによる多職種チームのコミュニケーション改善 #yjtc
 
「新しいおうち探し」のためのAIアシスト検索 #yjtc
「新しいおうち探し」のためのAIアシスト検索 #yjtc「新しいおうち探し」のためのAIアシスト検索 #yjtc
「新しいおうち探し」のためのAIアシスト検索 #yjtc
 
ユーザーの地域を考慮した検索入力補助機能の改善の試み #yjtc
ユーザーの地域を考慮した検索入力補助機能の改善の試み #yjtcユーザーの地域を考慮した検索入力補助機能の改善の試み #yjtc
ユーザーの地域を考慮した検索入力補助機能の改善の試み #yjtc
 

Recently uploaded

Recently uploaded (9)

ネットワーク可視化 振る舞い検知(NDR)ご紹介_キンドリル202405.pdf
ネットワーク可視化 振る舞い検知(NDR)ご紹介_キンドリル202405.pdfネットワーク可視化 振る舞い検知(NDR)ご紹介_キンドリル202405.pdf
ネットワーク可視化 振る舞い検知(NDR)ご紹介_キンドリル202405.pdf
 
LoRaWAN無位置ロープ式水漏れセンサーWL03A 日本語マニュアル
LoRaWAN無位置ロープ式水漏れセンサーWL03A 日本語マニュアルLoRaWAN無位置ロープ式水漏れセンサーWL03A 日本語マニュアル
LoRaWAN無位置ロープ式水漏れセンサーWL03A 日本語マニュアル
 
情報を表現するときのポイント
情報を表現するときのポイント情報を表現するときのポイント
情報を表現するときのポイント
 
部内勉強会(IT用語ざっくり学習) 実施日:2024年5月17日(金) 対象者:営業部社員
部内勉強会(IT用語ざっくり学習) 実施日:2024年5月17日(金) 対象者:営業部社員部内勉強会(IT用語ざっくり学習) 実施日:2024年5月17日(金) 対象者:営業部社員
部内勉強会(IT用語ざっくり学習) 実施日:2024年5月17日(金) 対象者:営業部社員
 
Hyperledger Fabricコミュニティ活動体験& Hyperledger Fabric最新状況ご紹介
Hyperledger Fabricコミュニティ活動体験& Hyperledger Fabric最新状況ご紹介Hyperledger Fabricコミュニティ活動体験& Hyperledger Fabric最新状況ご紹介
Hyperledger Fabricコミュニティ活動体験& Hyperledger Fabric最新状況ご紹介
 
LoRaWAN無位置ロープ型水漏れセンサー WL03A-LB/LSカタログ ファイル
LoRaWAN無位置ロープ型水漏れセンサー WL03A-LB/LSカタログ ファイルLoRaWAN無位置ロープ型水漏れセンサー WL03A-LB/LSカタログ ファイル
LoRaWAN無位置ロープ型水漏れセンサー WL03A-LB/LSカタログ ファイル
 
2024年5月17日 先駆的科学計算フォーラム2024 機械学習を用いた新たなゲーム体験の創出の応用
2024年5月17日 先駆的科学計算フォーラム2024 機械学習を用いた新たなゲーム体験の創出の応用2024年5月17日 先駆的科学計算フォーラム2024 機械学習を用いた新たなゲーム体験の創出の応用
2024年5月17日 先駆的科学計算フォーラム2024 機械学習を用いた新たなゲーム体験の創出の応用
 
Keywordmap overview material/CINC.co.ltd
Keywordmap overview material/CINC.co.ltdKeywordmap overview material/CINC.co.ltd
Keywordmap overview material/CINC.co.ltd
 
MPAなWebフレームワーク、Astroの紹介 (その1) 2024/05/17の勉強会で発表されたものです。
MPAなWebフレームワーク、Astroの紹介 (その1) 2024/05/17の勉強会で発表されたものです。MPAなWebフレームワーク、Astroの紹介 (その1) 2024/05/17の勉強会で発表されたものです。
MPAなWebフレームワーク、Astroの紹介 (その1) 2024/05/17の勉強会で発表されたものです。
 

Yahoo! ニュースにおける ドキュメント管理の事例紹介

  • 1. Copyright (C) 2020 Yahoo Japan Corporation. All Rights Reserved. ©2021 Yahoo Japan Corporation All rights reserved. Yahoo! ニュースにおける ドキュメント管理の事例紹介 ヤフー株式会社 メディア統括本部 ニュース担当 後藤拓実
  • 2. ©2021 Yahoo Japan Corporation All rights reserved. ⾃⼰紹介 2 •2012年にヤフー株式会社へ新卒⼊社 フロントエンド寄りのエンジニア • ニュースサービス担当10年⽬ • 2018年頃から技術刷新プロジェクトに携わる 現在は ウェブ版 Yahoo! ニュースのテックリードを担当
  • 3. ©2021 Yahoo Japan Corporation All rights reserved. 今⽇お話すること 3 シンプルなガイドラインを敷くことでドキュメントの改善が進んだ • Yahoo!ニュースにおけるドキュメントの課題 • 改善に向けて策定したガイドラインの紹介
  • 4. ©2021 Yahoo Japan Corporation All rights reserved. ヤフーにおけるドキュメント管理事情 4 •全社員で1つのコンフルエンスを利⽤ • 2006年に導⼊ 15年以上稼働 • 利⽤⽤途に縛りはなく⾃由に使える • 組織、プロダクト、プロジェクト、個⼈等の様々な単位 • メモ書きから⼿順書、議事録、組織情報など
  • 5. ©2021 Yahoo Japan Corporation All rights reserved. Yahoo! ニュースの組織 5 • 全職種含めておよそ200⼈ • プロジェクトやプロダクト等の数⼗のチーム • 表向き1サービスだが異なる組織の合流の歴史 そんな中、以下のようにコンフルエンスが使われていた • 基本的に1つのスペース配下に全チームのドキュメントを集約 • チームかシステム毎にポータル的なページがあり、 そのページ配下に関連する⽂書を⾃由に作っていく
  • 6. ©2021 Yahoo Japan Corporation All rights reserved. ドキュメントに関しての2018年頃の課題感 6 • スペース直下やチーム毎のページ直下にどんどんページが追加される • チーム内外問わず階層構造や⾒出しが整理されていない・統⼀感がない その結果、 • 辿りづらいのでブックマークしたり、⾃分⽤のリンク集を作ったりしがち • 資料が⼀時的な情報なのか、最新の情報なのか分かりづらい • ドキュメントを探す範囲が広くなりがちで時間を無駄にしてしまう • 整理されている感じがしないため探すときの⼼理的ハードルが⾮常に⾼い
  • 7. ©2021 Yahoo Japan Corporation All rights reserved. なぜこうなるのか 7 •広く適⽤できるような明⽂化された管理の⽅針がなかった • サービス内の組織横断で統⼀を働きかける機会がなかった • 致命的なボトルネックではないので問題とならなかった
  • 8. ©2021 Yahoo Japan Corporation All rights reserved. 改善に向けての取り組み 8 • ドキュメント管理のガイドラインを作成 • 2018年頃からの技術刷新の取り組みに合わせて適⽤
  • 9. ©2021 Yahoo Japan Corporation All rights reserved. どのようなガイドラインか 9 構造と⾒出しについてのシンプルなルール ① ページを3種のページ種別から構成する • ページの種類はポータル、リスト、コンテンツの3つ ② ページ⾒出しの命名規則を守る
  • 10. ©2021 Yahoo Japan Corporation All rights reserved. ①3つのページ種別 10 ポータルページ ファーストビューを重視した配下ページへのハブとなるページ リストページ コンテンツページをリスト化するためのページ コンテンツページ 実際に作業記録や議事録等の資料を書くページ
  • 11. ©2021 Yahoo Japan Corporation All rights reserved. 3つのページ種別による階層下の例 11
  • 12. ©2021 Yahoo Japan Corporation All rights reserved. 3つのページ種別による階層下の例 12
  • 13. ©2021 Yahoo Japan Corporation All rights reserved. ポータルページ 13 作成単位 • プロダクトやプロジェクト、案件といった任意の単位で作成 • ポータルの直下にポータルを設置することも可能 ページ内容 • 概要情報や配下のドキュメントを⾒つけやすくするためのページ。 • ポータルとしての機能が重要なので⾒やすさを優先して⾃由に構成して良い • ポータルの直下はリストかポータル
  • 14. ©2021 Yahoo Japan Corporation All rights reserved. ポータルページの画⾯構成の例 14
  • 15. ©2021 Yahoo Japan Corporation All rights reserved. リストページ 15 主にコンテンツページをまとめる階層を作るページ 作成単位 • コンテンツページの種類ごと(議事録、作業記録、⼿順書、設計書など) 内容 •⼦ページマクロ等を使い、配下にあるコンテンツページを⼀覧にしておくと良い • リストの直下はコンテンツページに限らず、同様なものが並んでいれば良い。 例えば、プロジェクトのポータルページが並ぶようなパターンもあり得る
  • 16. ©2021 Yahoo Japan Corporation All rights reserved. リストページの画⾯構成の例 16
  • 17. ©2021 Yahoo Japan Corporation All rights reserved. コンテンツページ 17 基本的にフリーフォーマットだが、以下は必須 ⽬次 • ⽂書の先頭で⽬次マクロを使い内容を俯瞰できるようにする • ⾒出しはh1から順番に正しく使う 概要 • ページの概要を簡潔に書く
  • 18. ©2021 Yahoo Japan Corporation All rights reserved. コンテンツページの画⾯構成の例 18
  • 19. ©2021 Yahoo Japan Corporation All rights reserved. ②ページ⾒出しの命名規則 19 基本 • 親ページの⾒出しに該当ページのタイトルを半⾓スペース区切りで繋げる • ポータルページでは上記を無視して名称の階層をリセットして良い ⽇付 • ⼀時的なドキュメントには⽇付を⼊れる(次ページで補⾜) • ⽇付のフォーマットはyyyy/mm/ddとする
  • 20. ©2021 Yahoo Japan Corporation All rights reserved. ⾒出しにおける⽇付の考え⽅ 20 保守していく資料なのか⼀時的なものなのかどうかによって⽇付を⼊れる 保守しないページには⽇付を⼊れる • 作業記録や議事録など、作成後に更新しないドキュメントが対象 • 作成する多くの資料は⼀時的なものであることが多い 保守していくページには⽇付を⼊れない • 設計書や⼿順書など、ページを作成後も保守するドキュメントが対象
  • 21. ©2021 Yahoo Japan Corporation All rights reserved. コンフルエンスのページ⾒出しの制約 21 同⼀スペース内で複数ページに同じタイトルは設定できない ガイドラインでは親ページの名前を受け継ぐ命名にすることでこの制約を回避 NG OK
  • 22. ©2021 Yahoo Japan Corporation All rights reserved. ③⾒る⼈の⽴場になって書く 22 ⽬次をつける • ドキュメントの全体構成を俯瞰できるように ⾒出しレベルを正しく使う • ⽬次をただしく出すためにh1から適切に使う • スタイルを変えるために使わない(少し太字にしたいからh5を使うなど)
  • 23. ©2021 Yahoo Japan Corporation All rights reserved. ガイドラインのポイント 23 シンプルなルール •ガイドラインを知らなくてもパターンが想像でき⾒様⾒真似でルールを守れる •こだわりが⽣まれやすいポイントの排除(⽇付フォーマット、区切り⽂字等) リスト構造と命名規則によりパターンが⽣まれる •パターンを認識できると整理されているように感じ、未知のドキュメントでも 探せる気になる。
  • 24. ©2021 Yahoo Japan Corporation All rights reserved. ガイドラインの浸透と継続のTips 24 プロジェクト開始時などの最初に⼟台を作ってしまう • 綺麗なところを汚そうとする⼈は少ない。⾒様⾒真似はしてくれる。 • 「作業記録」の置き場所をまず作ってしまう 定期的なガイドラインの共有 • 期初のキックオフ等の時にガイドラインを改めて共有する • 新しく⼊社した⼈にも都度伝える 定期的なメンテナンス • ガイドラインに沿ってないページを⾒つけたら適切な階層に移動・リネームする
  • 25. ©2021 Yahoo Japan Corporation All rights reserved. ガイドライン作成後の現在(個⼈的な感想) 25 チームを超えてドキュメントに統⼀感が⽣まれてきている • 技術刷新が進むに連れ複数のチームでドキュメントの改善が進んだ • 想像がつくようになり他チームのドキュメントでも辿りやすくなった どうあるべきか判断できるようになった • 整理されてない無造作に作られたページは全てコンテンツページ • 妥当なリストページ配下に移動してリネームすることで整理が進む
  • 26. ©2021 Yahoo Japan Corporation All rights reserved. EOP 26