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
GitHubでポータルサイトドキュメントを運営して幸せになる話 / Operating Por...
Search
iwashi
November 26, 2022
Technology
0
450
GitHubでポータルサイトドキュメントを運営して幸せになる話 / Operating Portal Site with GitHub Pages
GitHub Satellite Tokyo 2018 の LT にて、登壇したときの資料です。
iwashi
November 26, 2022
Tweet
Share
More Decks by iwashi
See All by iwashi
最高のステークホルダーになるために / Striving to be the best stakeholder
iwashi86
4
2.5k
n=1の経験が紡ぐエンジニアリングマネジメントの可能性 / The Possibilities of Engineering Management from n=1 Experiences
iwashi86
23
12k
エンジニアリングが好きな私たちのためのエンジニアリングマネジャー入門 / Engineering management for the rest of us
iwashi86
24
5.8k
エレガントパズル 30分 ダイジェスト版/ Elegant Puzzle 30min Digest
iwashi86
6
660
エレガントパズル エンジニアのマネジメントという難問にあなたはどう立ち向かうのか / Elegant Puzzle
iwashi86
18
4.4k
ベロシティを高く保つ仕事のすすめ方 / Maintaining a High Velocity as Productivity Hacks
iwashi86
54
21k
マネージャー&リーダー向け 社内トレーニング / Training of management and leadership for Stockmark
iwashi86
65
32k
30分でわかる「エンジニアのためのドキュメントライティング」- インフラエンジニアBooks / Docs for Developers within 30 minutes
iwashi86
9
2.6k
エンジニアのためのドキュメントライティング / Docs for Developers
iwashi86
34
23k
Other Decks in Technology
See All in Technology
完璧を目指さない小さく始める信頼性向上
kakehashi
PRO
0
130
FAST導入1年間のふりかえり〜現実を直視し、さらなる進化を求めて〜 / Review of the first year of FAST implementation
wooootack
1
220
東京海上日動におけるセキュアな開発プロセスの取り組み
miyabit
0
210
Perlアプリケーションで トレースを実装するまでの 工夫と苦労話
masayoshi
0
240
【2025 Japan AWS Jr. Champions Ignition】点から線、線から面へ〜僕たちが起こすコラボレーション・ムーブメント〜
amixedcolor
1
110
KCD Lima: eBee in Peru!
lizrice
0
110
少人数でも回る! DevinとPlaybookで支える運用改善
ishikawa_pro
5
2k
【CEDEC2025】『Shadowverse: Worlds Beyond』二度目のDCG開発でゲームをリデザインする~遊びやすさと競技性の両立~
cygames
PRO
1
160
Gemini in Android Studio - Google I/O Bangkok '25
akexorcist
0
100
LLMでAI-OCR、実際どうなの? / llm_ai_ocr_layerx_bet_ai_day_lt
sbrf248
0
370
手動からの解放!!Strands Agents で実現する総合テスト自動化
ideaws
3
420
LLM開発を支えるエヌビディアの生成AIエコシステム
acceleratedmu3n
0
350
Featured
See All Featured
Connecting the Dots Between Site Speed, User Experience & Your Business [WebExpo 2025]
tammyeverts
8
400
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
47
9.6k
Agile that works and the tools we love
rasmusluckow
329
21k
Balancing Empowerment & Direction
lara
1
510
Writing Fast Ruby
sferik
628
62k
Testing 201, or: Great Expectations
jmmastey
43
7.6k
4 Signs Your Business is Dying
shpigford
184
22k
Bash Introduction
62gerente
613
210k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
45
7.5k
Imperfection Machines: The Place of Print at Facebook
scottboms
267
13k
Distributed Sagas: A Protocol for Coordinating Microservices
caitiem20
331
22k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
8
860
Transcript
Copyright © NTT Communications Corporation. All rights reserved. GitHubでポータルサイト ドキュメントを運営して幸せになる話
GitHub Satellite Tokyo 2018 NTTコミュニケーションズ 岩瀬 義昌 / @iwashi86 2018.6.12
GitHub Pages※ 使ってますか? ※ 詳細は後述するが、簡単に言うとGitHubが提供する静的Webサイトのホスティング機能
GitHub Pages と CI/CD ※ を組み合わせてますか? ※ CI: Continuous Integration、継続的インテグレーションのこと
CD: Continuous Delivery・Deployment、継続的デリバリ・デプロイのこと
GitHub(Pages)をフル活用して 幸せになる方法を知ること 本LTのゴール
・岩瀬 義昌 / @iwashi86 ・WebRTC※ のPaaSである SkyWayのTech Lead ・Fukabori.fm(Podcast)主催 ※
音声・映像・データをリアルタイムに 通信するための技術のこと
SkyWayはGitHubと同じく開発者向けのサービス https://webrtc.ecl.ntt.com/
GitHub ・gitのホスティング(マネージ)、 Pull Request含む開発フロー、SNS など ・OSSや個人Publicリポジトリは無償
GitHub ・gitのホスティング(マネージ)、 Pull Request含む開発フロー、SNS など ・OSSや個人Publicリポジトリは無償 SkyWay ・WebRTCの面倒なところを マネージドとして提供 ・個人で作るサービスレベル※
ならまず無償 ※ 10万回の接続、500GB/月 のトラフィックは無償
本題
GitHub Pagesとは
GitHub Pagesとは ・静的Webサイトのホスティング機能
GitHub Pagesとは ・静的Webサイトのホスティング機能 ・GitHubがマネージしてくれるため運用レス
GitHub Pagesとは ・静的Webサイトのホスティング機能 ・GitHubがマネージしてくれるため運用レス ・開発者の個人ブログだけでなく 企業のウェブサイトに利用可能
gh-pagesの例: MicrosoftのWebサイト https://opensource.microsoft.com/
GitHub Pages を使う モチベーションとは?
1. GitHub を使うこと自体のメッセージ 2. CI/CD との組み合わせによる品質向上 補足:そもそも、マネージドによるWebホスティングなどもありますが SkyWayで活用するにあたり、特に価値があったと考える点に絞ります
1. GitHub を使うこと自体のメッセージ 2. CI/CD との組み合わせによる品質向上
1. GitHub を使うこと自体がメッセージ
1. GitHub を使うこと自体がメッセージ ・SkyWayは2013年12月にリリース GitHubのアカウントも公開
1. GitHub を使うこと自体がメッセージ ・SkyWayは2013年12月にリリース GitHubのアカウントも公開 ・このときの外部からの声
https://twitter.com/laiso/status/410226600362266624
1. GitHub を使うこと自体のメッセージ 2. CI/CD との組み合わせによる品質向上
そもそもエンジニア的にはドキュメントを…
・Markdown / reStructuredText で書きたい そもそもエンジニア的にはドキュメントを…
・Markdown / reStructuredText で書きたい ・git で管理して、Pull Request Drivenで 書きたい&レビューしたい (Wordは現時点でgitに向いていない)
そもそもエンジニア的にはドキュメントを…
・Markdown / reStructuredText で書きたい ・git で管理して、Pull Request Drivenで 書きたい&レビューしたい ・表記揺れなどのレビューは、
人間がやるものじゃない そもそもエンジニア的にはドキュメントを…
思いを反映した結果…
ドキュメント開発/運用の全体像(SkyWayでの例) 開発マシン GitHub ③テスト結果 (Pass/Fail)を返却 ②CircleCI上で、 textlintを使った テスト実行 ①ブランチを切って 文書を追加(mkdocs)
④レビューReady を通知 その他 メンバ ⑤文書レビュー ⑥GitHub Pagesに masterをデプロイ
開発マシン GitHub ③テスト結果 (Pass/Fail)を返却 ②CircleCI上で、 textlintを使った テスト実行 ①ブランチを切って 文書を追加 (MkDocs)
④レビューReady を通知 その他 メンバ ⑤文書レビュー ⑥GitHub Pagesに masterをデプロイ ドキュメント開発/運用の全体像(SkyWayでの例)
https://www.mkdocs.org/
MkDocs とは ・Markdownで書けるPythonベースの 静的Webサイトジェネレータ (類似のツールは Sphinx など)
MkDocs とは ・Markdownで書けるPythonベースの 静的Webサイトジェネレータ (類似のツールは Sphinx など) ・ビルドすると、HTML/JS/CSS を吐き出すので、
それを任意の方法でデプロイする e.g. GitHub Pages、S3へ置く
開発マシン GitHub ③テスト結果 (Pass/Fail)を返却 ②CircleCI上で、 textlintを使った テスト実行 ①ブランチを切って 文書を追加(mkdocs) ④レビューReady
を通知 その他 メンバ ⑤文書レビュー ⑥GitHub Pagesに masterをデプロイ ドキュメント開発/運用の全体像(SkyWayでの例)
textlint とは ・lintは元々、C言語用の構文・文法チェッカだったが 今では複数言語(e.g. html や golang )に対応
textlint とは ・lintは元々、C言語用の構文・文法チェッカだったが 今では複数言語(e.g. html や golang )に対応 ・textlintは、lintの適用範囲を拡張して、 文章に適用して、文章品質をテスト可能にしたツール
(類似のツールは、 RedPen など)
textlint とは ・lintは元々、C言語用の構文・文法チェッカだったが 今では複数言語(e.g. html や golang )に対応 ・textlintは、lintの適用範囲を拡張して、 文章に適用して、文章品質をテスト可能にしたツール
(類似のツールは、 RedPen など) ・NGを指摘するだけでなく、自動修正も可能
引用: https://qiita.com/azu/items/e36501d25593d008f6ac textlint の例 人間ではなくプログラムに指摘 -> 修正してもらう
開発マシン GitHub ③テスト結果 (Pass/Fail)を返却 ②CircleCI上で、 textlintを使った テスト実行 ①ブランチを切って 文書を追加(mkdocs) ④レビューReady
を通知 その他 メンバ ⑤文書レビュー ⑥GitHub Pagesに masterをデプロイ ドキュメント開発/運用の全体像(SkyWayでの例)
Circle CIとは ・定番の CI as a Service の1つ
Circle CIとは ・定番の CI as a Service の1つ ・リポジトリに書込権限の ある鍵を追加することで
デプロイまで実現可能
ドキュメント開発/運用の全体像(SkyWayでの例) 開発マシン GitHub ③テスト結果 (Pass/Fail)を返却 ②CircleCI上で、 textlintを使った テスト実行 ①ブランチを切って 文書を追加(mkdocs)
④レビューReady を通知 その他 メンバ ⑤文書レビュー ⑥GitHub Pagesに masterをデプロイ
まとめ
まとめ - 本日お話したこと
まとめ - 本日お話したこと ・GitHubの利用自体がメッセージの1つ
まとめ - 本日お話したこと ・GitHubの利用自体がメッセージの1つ ・GitHub Pages を CI/CD と組み合わせる方法
まとめ - 本日お話したこと ・GitHubの利用自体がメッセージの1つ ・GitHub Pages を CI/CD と組み合わせる方法 自サイト/ドキュメントの管理に
GitHubを活用してはいかがでしょうか? おしまい