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
ESDoc - ES6時代のドキュメンテーションツール
Search
Ryo Maruyama
June 26, 2015
Technology
6
2.4k
ESDoc - ES6時代のドキュメンテーションツール
Ryo Maruyama
June 26, 2015
Tweet
Share
More Decks by Ryo Maruyama
See All by Ryo Maruyama
MTG Playbookの使い方
h13i32maru
0
3.2k
チームでプロダクト開発するための取り組み/cookpadtechconf2017
h13i32maru
15
11k
ESDoc - ES6時代のドキュメンテーションツール - Node学園祭2015
h13i32maru
15
8.9k
Webフロントエンドパフォーマンスチューニング
h13i32maru
39
9.1k
Other Decks in Technology
See All in Technology
AIプロダクトのプロンプト実践テクニック / Practical Techniques for AI Product Prompts
saka2jp
0
100
CNCFの視点で捉えるPlatform Engineering - 最新動向と展望 / Platform Engineering from the CNCF Perspective
hhiroshell
0
140
SCONE - 動画配信の帯域を最適化する新プロトコル
kazuho
1
320
AI時代、“平均値”ではいられない
uhyo
8
2.4k
知覚とデザイン
rinchoku
1
470
Digitization部 紹介資料
sansan33
PRO
1
5.7k
QA業務を変える(!?)AIを併用した不具合分析の実践
ma2ri
0
120
もう外には出ない。より快適なフルリモート環境を目指して
mottyzzz
13
9.6k
OSSで50の競合と戦うためにやったこと
yamadashy
3
960
現場の壁を乗り越えて、 「計装注入」が拓く オブザーバビリティ / Beyond the Field Barriers: Instrumentation Injection and the Future of Observability
aoto
PRO
1
140
混合雲環境整合異質工作流程工具運行關鍵業務 Job 的經驗分享
yaosiang
0
170
JSConf JPのwebsiteをGatsbyからNext.jsに移行した話 - Next.jsの多言語静的サイトと課題
leko
2
180
Featured
See All Featured
Optimising Largest Contentful Paint
csswizardry
37
3.5k
We Have a Design System, Now What?
morganepeng
53
7.8k
RailsConf 2023
tenderlove
30
1.3k
Visualization
eitanlees
149
16k
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
sstephenson
162
15k
Chrome DevTools: State of the Union 2024 - Debugging React & Beyond
addyosmani
9
930
Designing for humans not robots
tammielis
254
26k
Keith and Marios Guide to Fast Websites
keithpitt
411
23k
Stop Working from a Prison Cell
hatefulcrawdad
272
21k
Mobile First: as difficult as doing things right
swwweet
225
10k
Save Time (by Creating Custom Rails Generators)
garrettdimon
PRO
32
1.7k
Being A Developer After 40
akosma
91
590k
Transcript
&4%PD &4࣌ͷυΩϡϝϯςʔγϣϯπʔϧ
ؙࢁ྄!IJNBSV $PPLQBE*OD
ॕ&$."4DSJQU BLB&4
&4࣌ͷ։ൃڥ ࢲݟ
&4࣌ͷ։ൃڥ ࢲݟ ίʔυ &4 #BCFM ςετ .PDIB QPXFSBTTFSU υΩϡϝϯτ +4%PD
+4%PDʹର͢Δෆຬ &4ʹະରԠ W JTTVF ग़ྗ͞ΕΔυΩϡϝϯτͬͱগ͠Ͱ͖Δ &4࣌ʹෆཁͳλά͕ଟ͍ ίʔυϕʔε͕&4 ෦Ͱ/PEFKTͱ3IJOP͕ࠞࡏ͍ͯ͠Δ
&4࣌ͷ։ൃڥ ࢲݟ ίʔυ &4 #BCFM ςετ .PDIB QPXFSBTTFSU υΩϡϝϯτ +4%PD
&4࣌ͷ։ൃڥ ࢲݟ ίʔυ &4 #BCFM ςετ .PDIB QPXFSBTTFSU υΩϡϝϯτ &4%PD
&4%PD OQNJOTUBMMFTEPD
&4%PD w &4ʹରԠ w શରԠʹ·ͩͪΐͬͱΓͳ͍ w 3FBDU+49ʹରԠ
&4%PD
&4%PD
&4%PDͷΰʔϧ ιʔείʔυΛݟͳͯ͘ ιϑτΣΞΛ͏͜ͱ͕Ͱ͖Δ υΩϡϝϯτΛੜ͢Δ͜ͱ
&4%PDͷΰʔϧ ιʔείʔυΛݟͳͯ͘ ιϑτΣΞΛ͏͜ͱ͕Ͱ͖Δ υΩϡϝϯτΛੜ͢Δ͜ͱ υΩϡϝϯτͷੑ࣭Λߟ͑ͯΈͨ
υΩϡϝϯτͷੑ࣭ w ܧଓੑ w ࣮༻ੑ w ཏੑ w ؔ࿈ੑ w
ݕࡧੑ
υΩϡϝϯτͷੑ࣭ w ܧଓੑˠΧόϨοδ w ࣮༻ੑˠৄࡉͳใ w ཏੑˠ੩తղੳΈ͍ͨͳͷ w ؔ࿈ੑˠςετͱͷΠϯςάϨʔτ
w ݕࡧੑˠݕࡧ &4%PDͰͷ࣮ݱํ๏
ΧόϨοδ w υΩϡϝϯτͷΧόϨοδ w શମͰԿॻ͔Ε͍ͯΔ͔ w ':*JODIDJPSH ܧଓੑ
ΧόϨοδ ܧଓੑ
ৄࡉͳใ ΫϥεҰཡ ϝιουҰཡ ϓϩύςΟҰཡ ܧঝؔ ܧঝϝιου ΦʔόʔϥΠυϝιο υ Ҿ Γ
σϑΥϧτҾ δΣωϦΫε %FQSFDBUFE &YQFSJNFOUBM 50%0 όʔδϣϯ ֎෦Ϋϥε FUD ࣮༻ੑ
੩తղੳͷΑ͏ͳͷ w λά͕ແͯ͘υΩϡϝϯτΛੜ w &4ͷσϑΥϧτҾΛͬͯҾͷܕΛਪଌ w SFUVSOจ͔ΒΓͷܕΛਪଌ /** * this
is useful function. */ function foo(p = 123) { return `p = ${p}`; } ཏੑ
੩తղੳͷΑ͏ͳͷ w λά͕ແͯ͘υΩϡϝϯτΛੜ w &4ͷσϑΥϧτҾΛͬͯҾͷܕΛਪଌ w SFUVSOจ͔ΒΓͷܕΛਪଌ ·࣮ͩݧతͳ࣮ͳͷͰੑ ೳ͓͍ͩ͘͠͞ /**
* this is useful function. */ function foo(p = 123) { return `p = ${p}`; } ཏੑ
ςετͱͷΠϯςάϨʔτ w ςετॏཁͳυΩϡϝϯτ w ΫϥεϝιουͷυΩϡϝϯτ㱻ରͷςετ ؔ࿈ੑ
ςετͱͷΠϯςάϨʔτ w ςετॏཁͳυΩϡϝϯτ w ΫϥεϝιουͷυΩϡϝϯτ㱻ରͷςετ ؔ࿈ੑ
ςετͱͷΠϯςάϨʔτ w ςετॏཁͳυΩϡϝϯτ w ΫϥεϝιουͷυΩϡϝϯτ㱻ରͷςετ ؔ࿈ੑ
ςετͱͷΠϯςάϨʔτ w ઃఆϑΝΠϧͰςετίʔυͷσΟϨΫτϦΛࢦఆ w ςετίʔυʹAA!UFTU\'PPCBS^AAΛهड़ /** @test {Foo} */ describe(‘Foo
is useful class’, ()=>{ /** @test {Foo#bar} */ it(‘is useful method’, ()=>{ let foo = new Foo(); assert(typeof foo.bar, ‘function’); }); }); ؔ࿈ੑ
ςετͱͷΠϯςάϨʔτ w ઃఆϑΝΠϧͰςετίʔυͷσΟϨΫτϦΛࢦఆ w ςετίʔυʹAA!UFTU\'PPCBS^AAΛهड़ /** @test {Foo} */ describe(‘Foo
is useful class’, ()=>{ /** @test {Foo#bar} */ it(‘is useful method’, ()=>{ let foo = new Foo(); assert(typeof foo.bar, ‘function’); }); }); ݱࡏ.PDIBͷΈͷରԠ ؔ࿈ੑ
ݕࡧ w Ϋϥε໊ ϝιου໊ ϓϩύςΟ໊ ϑΝΠϧ໊ ςετ໊ w ݕࡧΠϯσοΫε ݕࡧੑ
ͦͷଞ
Πϯϙʔτύε w υΩϡϝϯτͰJNQPSUͷํ๏ΛݟΕΔ
ΧελϚΠζ w ҙͷ+4ͱ$44ΛΈࠐΊΔ w ϑοΫϙΠϯτͷఏڙΛݕ౼த w λάͷύʔεޙ)5.-ͷੜޙ
ෆཁͳλάΛআ w +4%PDݸ w &4%PDݸ w Α͘͏ͷݸఔ w &4ʹͳͬͯෆཁʹͳͬͨͷ͕ଟ͍ w
ओʹΫϥεؔ࿈
վળ͕ඞཁͳͱ͜Ζ
վળ͕ඞཁͳͱ͜Ζ w υΩϡϝϯτͷϏϧυ࣌ؒ w ߦ!.#1ඵ w ࣮͕গͳ͍ͷͰෆ۩߹͕·ͩ͋Δ w FTEPDJTTVFT w
ϗεςΟϯά w SVCZEPDJOGPͱ͔HPEPDPSHΈ͍ͨͳͷཉ͍͠
·ͱΊ
·ͱΊ w &4ͷυΩϡϝϯτͳΒ&4%PDࢼͯ͠Έͯʂ w υΩϡϝϯτॻ͘ͱॻ͖खʹ͍͍͜ͱ͕͋Δʂ w *TTVF134UBS͓͍ͪͯ͠·͢ʂ 5IBOLZPVGPSDPOUSJCVUJPO
એ
$PEF-VODIGN (P '1(" 1)1 FUD
͓ΘΓ w FTEPDPSH w DPEFMVODIGN w JODIDJPSH w HJUIVCDPNKTEPDKTEPDJTTVFT