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
conventional-changelog
Search
kazupon
August 08, 2016
Technology
1
2k
conventional-changelog
kazupon
August 08, 2016
Tweet
Share
More Decks by kazupon
See All by kazupon
わたしのOSS活動
kazupon
3
500
Vapor Revolution
kazupon
3
3.5k
Vue.js最新動向
kazupon
3
1.5k
Vue 3.4
kazupon
13
4.7k
Vue & Vite Rustify
kazupon
4
2.3k
Vue.jsエコシステム動向2023
kazupon
17
7.9k
Reactivity Transform
kazupon
1
1.4k
わたしのOSS活動
kazupon
1
1k
Vue with Vite
kazupon
2
2.6k
Other Decks in Technology
See All in Technology
Mambaで物体検出 完全に理解した
shirarei24
2
170
ファインディにおける Dataform ブランチ戦略
hiracky16
0
240
20250728 MCP, A2A and Multi-Agents in the future
yoshidashingo
1
180
風が吹けばWHOISが使えなくなる~なぜWHOIS・RDAPはサーバー証明書のメール認証に使えなくなったのか~
orangemorishita
14
4.7k
興味の胞子を育て 業務と技術に広がる”きのこ力”
fumiyasac0921
0
500
AI時代の知識創造 ─GeminiとSECIモデルで読み解く “暗黙知”と創造の境界線
nyagasan
0
180
AI人生苦節10年で会得したAIがやること_人間がやること.pdf
shibuiwilliam
1
250
【CEDEC2025】『Shadowverse: Worlds Beyond』二度目のDCG開発でゲームをリデザインする~遊びやすさと競技性の両立~
cygames
PRO
1
200
AI時代の経営、Bet AI Vision #BetAIDay
layerx
PRO
1
790
【Λ(らむだ)】最近のアプデ情報 / RPALT20250729
lambda
0
210
AI駆動開発 with MixLeap Study【大阪支部 #3】
lycorptech_jp
PRO
0
290
人と生成AIの協調意思決定/Co‑decision making by people and generative AI
moriyuya
0
240
Featured
See All Featured
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
8
860
Building a Scalable Design System with Sketch
lauravandoore
462
33k
GitHub's CSS Performance
jonrohan
1031
460k
Building an army of robots
kneath
306
45k
Save Time (by Creating Custom Rails Generators)
garrettdimon
PRO
31
1.3k
GraphQLとの向き合い方2022年版
quramy
49
14k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
21
1.4k
Navigating Team Friction
lara
188
15k
VelocityConf: Rendering Performance Case Studies
addyosmani
332
24k
Music & Morning Musume
bryan
46
6.7k
Adopting Sorbet at Scale
ufuk
77
9.5k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
30
2.2k
Transcript
Conventional Changelog ౦ژNodeֶԂ #22 2016-08-08 @kazupon
ࣗݾհ https://github.com/kazupon
ҰԠϝϯόʔͳͷͰࣄ͠ʹ͖·ͨ͠ ͜Ε
ࠓ͢͜ͱ
Conventional Changelog
ຊʹೖΔલʹ
None
changelog (มߋཤྺ) ॻ͍ͯ·͔͢ʁ ຊʹೖΔલʹ
changelog ॻ͔ͳ͍ཧ༝ طʹ Git ͳͲͷόʔδϣϯཧπʔϧͰมߋ༰ͱ͔ ॻ͍ͯ͋Δ͔Βɺgit log GitHub ͱ͔ͰάϥϑΟΧ
ϧͳͷͰݟΕΔ͔Βɺॻ͔ͳ͍͍ͯ͘Ͱ͠ΐ
changelog ॻ͔ͳ͍ཧ༝ MS WordɺGoogle docs ͳͲͷผͳυΩϡϝϯτͰ ͲͬͪΈͪॻ͔͘Βɺಉ͡Α͏ͳ͜ͱͨ͘͠ͳ͍
ͦͦॻ͘ͷ͕ΊΜͲ͍ʂ ॻ͔ͳ͍࠷େཧ༝
झຯɺϓϩτλΠϓతͳ ͷͳΒɺ·͍͍͋ͱͯ͠
ଞͷਓʹΘΕΔιϑτΣΞ Λ։ൃͯ͠ఏڙ͍ͯ͠Δͷʹɺ ΊΜͲ͍ͬͯݴͬͯΔͷ
None
changelog ඞཁͩ มߋ࣌ มߋऀ ରόʔδϣϯ มߋ༰ ιϑτΣΞͷมߋ༰Λ࣌ܥྻͰ ֓ཁΛѲ͢Δͷʹ༰қ
changelog ͍ΖΜͳਓ͕ಡΉ WebαʔϏεɺΞϓϦɺ ۀγεςϜͳͲͷιϑ τΣΞ։ൃ͍ͯ͠ΔΤ ϯδχΞ σβΠφʔ͞ΜͷΑ͏ͳ ։ൃʹܞΘ͍ͬͯΔ non- tech
ͳਓ ҰମԿ͕มߋ͞ΕͨΜͩΖ͏ʁ ͨͯ͠ΞοϓάϨʔυ͢Δඞཁ͕͋Δ ͷͩΖ͏͔ʁ
͜ΕΛػʹॻ͍͍ͯͳ͔ͬͨਓ ɺchangelog ॻ͖·͠ΐ͏ʂ
͋͋ɺchangelog ͕େࣄͳͷ ͔ͬͨ
ͰɺGit Ͱ͏طʹมߋ༰ ͱ͔ॻ͍ͯ͋Δͷʹɺ ಉ͡Α͏ͳ͜ͱͨ͘͠ͳ͍ͳ͋
ͳΜ͔ɺָʹ changelog ॻ ͚ΔΑ͏ʹɺΑ͠ͳʹͬ ͯ͘ΕΔͷͳ͍ͷʁ
ͱࢥ͏ਓ͕͍Δͱࢥ͍·͢
ͦ͜Ͱ͜Ε͕ग़൪Ͱ͢Αʂ
Conventional Changelog ͱ changelog ͷͨΊͷίϛοτϝοηʔδن CLI πʔϧίϛοτϝοηʔδنΛݩʹ changelog ΛੜͰ͖ΔΈΛఏڙ
Conventional Changelog ಈ࡞Πϝʔδ ίϛοτϩά changelog ϑΝΠϧ ίϛοτϝοηʔδن ϑΝΠϧ CLI ࣗಈੜ
!!
ੜ͞Εͨ changelog ͷத ίϛοτϋογϡ͔Β GitHubͷURLΛඥ͚ͯ͘ΕΔ มߋ༰ΛάϧʔϓԽͱ͔ ͯ͘͠ΕͨΓ͢Δ ྫ: karma ͷ
CHANGELOG.md
جຊతͳ։ൃ࡞ۀͷྲྀΕ (͍ํ)
1. ։ൃ࡞ۀ ࣮ or मਖ਼ ςετ
2. Git Ͱίϛοτ ։ൃ࡞ۀͰมߋͨ͠ͷΛίϛοτ
3. package.json ͷόʔδϣϯΛ্͛Δ όʔδϣϯΛมߋ
4. CLI πʔϧΛ࣮ߦ $ conventional-changelog -i CHANGELOG.md -s -p angular
5. changelog ϑΝΠϧͱ package.json Λίϛοτ front-endͷΑ͏ͳϏϧυͨ͠ͷඞཁͳΒͦΕί ϛοτ
6. Git Ͱλά͚ git tag ͰόʔδϣϯΛλά͚
7. ϦϦʔε git push ͰϦϙδτϦʹΞοϓϩʔυ ඞཁʹԠͯ͡ npm publish
ಋೖ͢Δࡍͷҙ ιʔεͰ͋Δ Git ίϛοτϩά͕μϝͩͱɺੜ͞ ΕΔ changelog μϝͳͷ͕ੜ͞ΕΔ ίϛοτϝοηʔδنʹैͬͯɺྑ͍ίϛοτϝο ηʔδΛॻ͘͜ͱ͕ॏཁ
ίϛοτϝοηʔδن ϓϦηοτ angular https://github.com/conventional-changelog/conventional-changelog-angular jquery https://github.com/conventional-changelog/conventional-changelog-jquery ember https://github.com/conventional-changelog/conventional-changelog-ember express https://github.com/conventional-changelog/conventional-changelog-express
ίϛοτϝοηʔδن ϓϦηοτ jshint https://github.com/conventional-changelog/conventional-changelog-jshint eslint https://github.com/conventional-changelog/conventional-changelog-eslint code mirror https://github.com/conventional-changelog/conventional-changelog-codemirror atom
https://github.com/conventional-changelog/conventional-changelog-atom
❤͓קΊϓϦηοτ ❤
ಠࣗίϛοτϝοηʔδ نͷఆٛ ͪΖΜࣗͰίϛοτϝοηʔδنΛఆٛ͢Δ ͜ͱ͕Ͱ͖Δ ΦϨΦϨ ίϛοτϝοηʔδن
Angular ͷίϛοτϝοηʔδنΛ֦ு ͯ͠ emoji ʹରԠͨ͠ྫ https://github.com/kazupon/git-commit-message-convention
ಠࣗίϛοτϝοηʔδͷఆٛ(֦ு)
JSͰΧελϜϝοηʔδنΛ࣮ changelog ʹ ॻ͖ࠐΉࡍͷ άϧʔϓมઃఆ ίϛοτϝοηʔδ ͔Βநग़͢Δύλʔϯઃఆ
ੜ͞Εͨ changelog emoji ίʔυ͕ೖͬͨάϧʔϐϯά ಠࣗʹఆٛͨ͠άϧʔϓ ಠࣗʹఆٛͨ͠ notekeywords
emoji ೖΓͰมߋཤྺ͕දࣔ
ςϯϓϨʔτͷΧελϚΠζ handlebars ه๏ ͰΧελϚΠζͰ͖Δ ϑΝΠϧ جຊ markdown ܗࣜ
ςϯϓϨʔτͷߏ جຊ template.hbs ʹҎԼͷΑ͏ʹ ߏԽ͞Ε͍ͯΔ - header - commitGroups -
commits - commit - footer (͋Ε) ڽͬͨςϯϓϨʔτͷΧελϚΠζΛ͍ͨ͠߹ɺ ఏڙ͞Ε͍ͯΔίϛοτϝοηʔδنͷ֤ϓϦηο τͷ templates σΟϨΫτϦΛࢀߟʹ͢ΔͱΑ͍
Angular ίϛοτϝοηʔδنͷ ςϯϓϨʔτ https://github.com/conventional-changelog/conventional-changelog-angular/tree/master/templates
GitHub Release Integration conventional-github-releaser Ͱ GitHub Release ͱ࿈ ܞ͢Δ͜ͱՄೳ $
conventional-github-releaser -p angular -r 0
API Conventional Changelog Ͱఏڙ͍ͯ͠Δ CLI πʔϧ Ͱຬग़དྷͳ͍߹ɺఏڙ͍ͯ͠Δ API Λۦ͠ ͯಠࣗπʔϧ࡞Δ͜ͱՄೳ
Linter: conventional-changelog-lint https://github.com/marionebl/conventional-changelog-lint
πʔϧͱͷ࿈ܞ Gulp changelog ੜΛλεΫʹΑΔࣗಈԽ https://github.com/conventional-changelog/gulp-conventional-changelog Grunt GitHub Release ΛλεΫʹΑΔࣗಈԽ https://github.com/conventional-changelog/grunt-conventional-github-releaser
Atom https://github.com/conventional-changelog/atom-conventional-changelog
Atom ʹఏڙ͞Ε͍ͯΔπʔϧ Changelog Λੜɺ·ͨ GitHub Release ͕Ͱ͖Δ
ͦͷଞศརπʔϧ standard-changelog Angluar ίϛοτϝοηʔδنʹಛԽͨ͠πʔϧ https://github.com/conventional-changelog/standard-changelog standard-version Angular ίϛοτϝοηʔδنϕʔεͰɺchangelog ੜɺࣗ ಈόʔδϣχϯά͠ɺGitHub
Squash ͞Εͨίϛοτϩάʹର Ԡ https://github.com/conventional-changelog/standard-version conventional-recommended-bump Ͳͷόʔδϣϯ(major/minior/patch)Ξοϓͳͷ͔ڭ͑ͯ͘ΕΔ πʔϧ https://github.com/conventional-changelog/conventional-recommended-bump
ར༻͍ͯ͠ΔϓϩδΣΫτ Conventional Changelog https://github.com/conventional-changelog Angular https://github.com/angular/angular Karma https://github.com/karma-runner/karma JSHint https://github.com/jshint/jshint
Vue.js (vue-validator) https://github.com/vuejs/vue-validator … ͳͲ
·ͱΊ changelog ॏཁͳͷ Conventional Changelog ͰΊΜͲ͏ͳ changelog Λࣗಈੜ͢Δ͜ ͱ͕Ͱ͖Δ Conventional
Changelog ͍Ζ͍Ζศར CLI πʔϧͱΧελϚΠζΛ ఏڙ ίϛοτϝοηʔδن changelog ग़ྗςϯϓϨʔτ API ͳͲ ಋೖ͢Δ͜ͱͰιϑτΣΞ։ൃͷཤྺཧͷΈͳͣɺϦϦʔεɺόʔ δϣχϯάͱָ͔ʹͳΕΔ
Happy changelogging!!