Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
ドキュメンテーションのすヽめ_#MLbeginners
Search
ninohira
October 27, 2019
Technology
1
670
ドキュメンテーションのすヽめ_#MLbeginners
ML for Beginners! MeetUp登壇資料
#MLbeginners
ninohira
October 27, 2019
Tweet
Share
More Decks by ninohira
See All by ninohira
[ICML2021 論文読み会]Revisiting Rainbow: Promoting more Insightful and Inclusive Deep Reinforcement Learning Research
ninohira
0
1.4k
[論文紹介]Jukebox: A Generative Model for Music
ninohira
0
640
無駄分析を避ける為にデータサイエンティストに求められる能力
ninohira
3
12k
アーティストにとっての「愛」とは?~What is ”Love" for artist?~
ninohira
1
9.8k
Data Gateway Talk Vol.5運営資料
ninohira
1
480
今再びのRによる因果推論_Causal Interference by R_#japanr
ninohira
2
10k
因果推論の基礎とその罠 _Basic and Trap of Causal Inference_#白金鉱業
ninohira
5
12k
Data Gateway Talk Vol.1運営資料
ninohira
1
3k
新卒が考えた理想のDS新卒研修
ninohira
1
760
Other Decks in Technology
See All in Technology
ExaDB-D dbaascli で出来ること
oracle4engineer
PRO
0
3.8k
強いチームと開発生産性
onk
PRO
34
11k
AWS Media Services 最新サービスアップデート 2024
eijikominami
0
200
OCI 運用監視サービス 概要
oracle4engineer
PRO
0
4.8k
New Relicを活用したSREの最初のステップ / NRUG OKINAWA VOL.3
isaoshimizu
2
600
誰も全体を知らない ~ ロールの垣根を超えて引き上げる開発生産性 / Boosting Development Productivity Across Roles
kakehashi
1
230
Terraform CI/CD パイプラインにおける AWS CodeCommit の代替手段
hiyanger
1
240
Terraform未経験の御様に対してどの ように導⼊を進めていったか
tkikuchi
2
430
組織成長を加速させるオンボーディングの取り組み
sudoakiy
2
120
Lambda10周年!Lambdaは何をもたらしたか
smt7174
2
110
Amplify Gen2 Deep Dive / バックエンドの型をいかにしてフロントエンドへ伝えるか #TSKaigi #TSKaigiKansai #AWSAmplifyJP
tacck
PRO
0
380
B2B SaaSから見た最近のC#/.NETの進化
sansantech
PRO
0
800
Featured
See All Featured
Fontdeck: Realign not Redesign
paulrobertlloyd
82
5.2k
Done Done
chrislema
181
16k
Keith and Marios Guide to Fast Websites
keithpitt
409
22k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
44
6.8k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
4
370
Designing Dashboards & Data Visualisations in Web Apps
destraynor
229
52k
KATA
mclloyd
29
14k
StorybookのUI Testing Handbookを読んだ
zakiyama
27
5.3k
How to train your dragon (web standard)
notwaldorf
88
5.7k
The Invisible Side of Design
smashingmag
298
50k
Large-scale JavaScript Application Architecture
addyosmani
510
110k
Fashionably flexible responsive web design (full day workshop)
malarkey
405
65k
Transcript
υΩϡϝϯςʔγϣϯͷ͢ʍΊ Recommend to Documentation
Recommend to Documentation 免責事項 / お願い - 本登壇は個⼈の⾒解であり、所属する組織の公式⾒解ではありません - 社会⼈2年⽬のビギナーなので優しい⽬で⾒てください
-「お気持ち」的な内容がメインになります - 受託分析データサイエンティスト視点なので、多少バイアスがあります - ツイッターにたくさんつぶやくと運営&⾃分が喜びますので、たくさんツイートしてください 2/14
Recommend to Documentation 質問 ドキュメンテーション⼤切だと感じたことある⽅︕︕ (深掘り) いつ / どうして そう思ったかを
考えました︖ 「誰か」に「何か」を伝えることって⼤切
Recommend to Documentation ⾃⼰紹介 学⽣ 早稲⽥⼤学 創造理⼯学研究科 経営システム⼯学専攻 共同研究先のマーケティングデータ ×
データサイエンス 仕事 データサイエンティスト @BrainPad 2018年新卒 強化学習 / NLP / 統計的因果推論 / 画像異常検知 趣味 仁ノ平 将⼈ Masato Ninohira (@nino_pira) Data Gateway Talk 主催 B’zファン(⾳楽×データ分析のイベント企画now) ブログ︓データサイエンティスト⾒習いの⽇常 フットサル 4/14
Recommend to Documentation ⽬次 - Why Documentation? - ドキュメントの分類 -
コード / 分析レポート - まとめ 5/14
Recommend to Documentation ⾃分の記憶の共有 = 不可能 Why Documentation︖ Impossible to
SHARE Brain 「誰か」に「何か」を伝えたい Idea ケースに応じたドキュメンテーション Want to SHARE Idea SHARE by Document SHARE 6/14
Recommend to Documentation ドキュメントの分類 ※MECEではないです。作為的に⽊を切っています ※「メール / 議事録」も考えましたが、分析内容を 直接書くことは稀だと思いましたのでスコープ外 Who
- 分析チーム - 意思決定者 - コンピュータ - 分析結果 / next アクション - 意思決定者への レポートに必要な素材選定 - ⾃分のコードの確認 - 分析の結果を正しく伝え、意思決定のサポート - 回るコード / 早いコード - 分析レポート - コード - 分析レポート What Document - コード 「誰」に「何を伝えたいか」の構造化が良いドキュメント化へのポイント 7/14
Recommend to Documentation コード コンピュータ & ⼈間に読みやすいコード 計算速度 冗⻑なコードの回避 例︓
組み込み関数のsumを使う 可読性の⾼い実装 - 明瞭なディレクトリ構成 - コーディング規約 /適切なコメント - 明瞭なプルリク 8/14
Recommend to Documentation 参考︓ ディレクトリ構造のテンプレ ⾃分はこれに⾃分専⽤の 開発環境特化素材を加えてる (例︓Docker) 9/14
Recommend to Documentation 分析レポート 前提 1. 分析には「⽬的」があり「概要」/ 「結果」があり「Next Action」が絶対にある 2.
対象者が求めているレベル感に合わす 意思決定者 詳しく知りたい 結果だけ知りたい 分析メンバー 社内wiki / 分析レポート 詳しく知らせる必要がある スライド 作成モデルをシステム化することでxx万円の売り上げ向上 コスト︓xxx Income︓xxx ROI︓xxx (期間︓zzxxx~xxxx) 作成モデルをシステム化することでxx万円の売り上げ向上 モデルの精度 学習︓xxx テスト︓xxx 分析⽬的︓xxxx 概要︓xxxx 結果︓xxxx Next Action︓xxxx 詳細︓xxx ※綺麗なスライドの作り⽅は世の中に 良い本がたくさんあるのでそちらで学んで頂ければと思います Who Level Doc ロジックツリー ここがxx%up 結局、分析結果をステークホルダーに伝えられないとその分析に価値はない 10/14
Recommend to Documentation 参考︓コンフルエンスを⽤いた分析レポート作成 オンラインで共有 = 情報の共有の閾値が低 (全ての実験結果をコンフルに記載) 11/14
Recommend to Documentation 参考︓分析レポート以外の記事もたくさん書いてます 12/14
Recommend to Documentation 参考︓どう鍛えるの︖ 意識して経験するしかないと思っています。。。 Do Best Every Time ※むしろ良い⽅法をご存知の⽅教えてください、、、
13/14
Recommend to Documentation まとめ - 情報の伝達⼿段としてドキュメンテーションは有効 - 「誰」に「何を」伝えたいかの「構造化」を意識したドキュメント化 14/14
Recommend to Documentation 参考⽂献 - はじめてのNoteと、ドキュメンテーションについて (本登壇はこの資料に超影響を受けてます) - 1分で話せ 世界のトップが絶賛した⼤事なことだけシンプルに伝える技術
- イシューからはじめよ 知的⽣産の「シンプルな本質」 - なぜあなたのPull Requestは読まれないのか - Cookiecutter Data Science