Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
初心者に優しい技術記事の見分け方
Search
Sponsored
·
Your Podcast. Everywhere. Effortlessly.
Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.
→
Takashi Udagawa
February 21, 2019
Programming
230
1
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
初心者に優しい技術記事の見分け方
公式ドキュメントを読むのにハードルが高い初心者がどうやって適切な技術記事を選ぶかの話です
Takashi Udagawa
February 21, 2019
Transcript
37 slides
初心者に優しい技術記事 の見分け方 @udayan28 WeJS 2019/02/21
自己紹介 イケてるエンジニアのための転職サービスを作ってい ます@Findy UX Developer(なんでも屋?) 開発(React, Rails) 企画・仕様策定 リリースブログ・ユーザーインタビューetc 元ソシャゲプランナーʕº̫͡ºʔ
好きなもの 本と映画 最近おもしろかったもの ズーランダー2(コメディ映画) 世界神話辞典(各国の神話の起源とかがサクッと読 める文庫)
話すこと、話さないこと 話すこと 初心者に優しい技術記事について 話さないこと JavaScriptについて(???)
先日こんな記事を見かけました 私たちはどうして公式ドキュメントが読めないのか? https://qiita.com/hiraike32/items/f0a211cceb0ecc516b6c
読んで思ったこと 「公式ドキュメント読め」はとても分かるし、中級以 上のエンジニアは読んでる でも、初心者には無理じゃなかろうか??? 当時の私には無理でした!!!(怒
ここでいう初心者とは 下記のような人 入門書1冊 or Progate終わった フレームワーク入門終わった
なぜ初心者は公式ドキュメントが 読めないのか 探したい情報を探せない ドキュメントが整備されていない 英語わからない
探したい情報を探せない そもそも公式ドキュメントはどれ??? GitHub? 日本語版?英語版? 公式ドキュメントごとに微妙に構造違って情報にたど りつけない 検索使おうにも知らないことは検索できない
ドキュメントが整備されていない 更新が間に合っていない(翻訳版にありがち) 更新されていない(GitHubは更新されているw) ドキュメントがない or 各方面からドキュメントのポ ンコツさを指摘されているが直らない
英語わからない 英語で新しい概念を勉強するのそれなりにつらくない です? 英語からは逃げられないが、初心者には酷 Google翻訳はあるが、結構きついw ReactのState = 州 or 状態
同じくProps = プロップ or 小道具
じゃあ、初心者はどうす るか・・・?
日本語の技術記事を読み ますʕº̫͡ºʔ
というわけで・・・
初心者に優しい技術記事 の見分け方
技術記事を読むときの心構え 書いてあることが正しいかは自分で判断するしかない 新しい記事=良いではないときもある よくあるのが他の人のブログやQiitaをなぞっただ けの記事・メモ 古いものがそのまま使われていることもある(node だとndenvとか) できる限り正確である可能性が高いものを選ぶ 公式ドキュメント 書籍
or コミッターや業界で有名な人の技術ブログ その他の技術記事
初心者に優しい技術記事とは 最低でも1つ、多い方が優しい(初心者が詰みにく い) 環境・バージョン等が書かれている 参考にした記事・ドキュメント等が書かれている ソースコード全体が公開されている
環境・バージョン等が書かれてい る 学習したいことに集中できる 書かれていないとどうなるか? 初心者は環境構築だけでつまづく ex. Aは入りません、そんなコマンドはない ググって解決できなければ詰み
参考記事・ドキュメント等が書か れている 動かない等エラーが出たら、参考文献に飛べる 記載されていないとどうなるか? 動かなかった瞬間にググり地獄が始まる 適切な回答を見つけられなければ詰み
ソースコード全体が公開されてい る 依存関係やソース全体が分かるため、変なエラーを産 まない 細切れのソースコードだとどうなるか? どこに書いていいのか迷う そして、変なところに書いて詰む 未記載のライブラリとか使われていると詰む
この3つがあれば、詰む可能性が減 らせる! 環境・バージョン等が書かれている 参考にした記事・ドキュメント等が書かれている ソースコード全体が公開されている
やったね!
?
全然やってない
公式ドキュメントからは逃げられ ない 参考記事・書籍には、ほぼほぼ公式ドキュメントが出 てくる 脱初心者には公式ドキュメントを読むのが必須 公式ドキュメント読めないと最新情報のキャッチアッ プができない
じゃあ、どうするか?
公式ドキュメントに慣れ よう!
公式ドキュメントに慣れるために まずは公式ドキュメントを見つけよう 良く使うメソッドを公式ドキュメントで探そう 色々なページを見てみよう
まずは公式ドキュメントを見つけ よう 正確なソースを知ることができる 分からなければ、知り合いに聞こう!
良く使うメソッドを公式ドキュメ ントで探そう 公式ドキュメント内で検索できるようになる 公式ドキュメントでメソッドの定義を読めるようにな る
console.logをMDN内で検索する
色々なページを見てみよう 既知から未知へのアクセス ドキュメントの構造を知ってアクセスの効率化
console.logからconsoleオブジェ クトのページへ
公式ドキュメントは慣れれば勝 ち!
まとめ 初心者に優しい技術記事とは 環境・バージョン等が書かれている 参考にした記事・ドキュメント等が書かれている ソースコード全体が公開されている
優しい技術記事から公式 ドキュメントにステップ アップ!
ありがとう ございました!
More Decks by Takashi Udagawa
See All by Takashi Udagawa
プロダクトリリースと心理的安全性
udayan28
1
2.1k
1週間でReactにほぼ0から入門する
udayan28
0
600
Other Decks in Programming
See All in Programming
エラーチャンネルのボールを拾い続けて鍛えるエンジニアの地力 / phpcon-niigata2026
meihei3
1
440
AWS CDKを理解するために公式の定義を深掘って解説してみる / Understanding AWS CDK by Digging into Its Official Definition
akihisaikeda
3
310
AI駆動開発4年目の現在地(『あなたはFDEになるべきか?』イベント資料)
kumaiu
0
660
선언형 햅틱 라이브러리 진동을 소개합니다
l2hyunwoo
1
320
[DroidKnights 2026] Workflow AX: From Auto-Documented Policies to E2E Testing
raeminkang
0
590
Kotlin JVM用に作られたライブラリのKMPを前提とした再設計
jsoizo
0
180
Scalaの型でマルチテナントの認可を守る
nextbeatdev
0
160
[DroidKnights 2026] Workflow AX 적용기 — 자동 정책 정리부터 E2E까지
dayeon
0
110
ビジネスロジックを堅牢に~Scala 3のドメインプリミティブ~
j5ik2o
0
200
LLM 101
dalinaum
0
510
仕様駆動開発入門 (何を作るかを先に決めて渡す) | 目指せ Kiro マスター 05
inariku
PRO
2
190
Goコンパイラを作ってGoをもっと理解する / Build a Go compiler to better understand Go
ikura_hamu
0
130
Featured
See All Featured
How to Get Subject Matter Experts Bought In and Actively Contributing to SEO & PR Initiatives.
livdayseo
1
250
Balancing Empowerment & Direction
lara
6
1.4k
Build The Right Thing And Hit Your Dates
maggiecrowley
39
3.5k
Claude Code どこまでも/ Claude Code Everywhere
nwiizo
68
60k
Sam Torres - BigQuery for SEOs
techseoconnect
PRO
0
610
sira's awesome portfolio website redesign presentation
elsirapls
0
510
Optimising Largest Contentful Paint
csswizardry
37
4k
Heart Work Chapter 1 - Part 1
lfama
PRO
11
37k
How To Speak Unicorn (iThemes Webinar)
marktimemedia
1
640
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
35
2.6k
Navigating Algorithm Shifts & AI Overviews - #SMXNext
aleyda
1
1.7k
Exploring the relationship between traditional SERPs and Gen AI search
raygrieselhuber
PRO
4
4.4k