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 Portal Site with GitHub Pages
Search
iwashi
November 26, 2022
Technology
0
220
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
ベロシティを高く保つ仕事のすすめ方 / Maintaining a High Velocity as Productivity Hacks
iwashi86
47
14k
マネージャー&リーダー向け 社内トレーニング / Training of management and leadership for Stockmark
iwashi86
52
28k
30分でわかる「エンジニアのためのドキュメントライティング」- インフラエンジニアBooks / Docs for Developers within 30 minutes
iwashi86
9
2.1k
エンジニアのためのドキュメントライティング / Docs for Developers
iwashi86
29
18k
なぜ変化を起こすのが難しいのか? - 数年以上にわたって難しさに向き合い・考え取り組んできたこと / The reason why changing organization is so hard - What I thought and faced for more than several years
iwashi86
59
81k
2015年 第4四半期の WebRTC 標準化 アップデート / 2015 update of WebRTC Standards
iwashi86
0
180
外注が主な企業でどのように内製開発を立ち上げ・進化させているのか? / how we start in-house developement in enterprise?
iwashi86
2
30k
Extreme testing of WebRTC Applications
iwashi86
0
120
2019 IaaS Workshop in training for new employee at NTT Com
iwashi86
0
110
Other Decks in Technology
See All in Technology
上手く活用すればコスト削減につながる、ONTAPの Temperature Sensitive Storage Efficiency (TSSE) の紹介
non97
0
230
意義から考えるObservability入門 #srenext
stefafafan
2
840
異次元のCloudFormation 拡張コマンド~Rain~
watany
0
120
チームでテストを実装していく / Implementing Tests as a Team
ropqa
0
180
シリーズAをリファラル採用中心に走り抜ける / leaner-referral-engineer-2024
corocn
3
1.2k
Nuxt DevTools 101
nozomuikuta
3
350
MySQL 8.4 LTS が あらわれた
yoku0825
PRO
1
140
開発生産性 超入門 / development productivity introduction
igsr5
10
2.7k
Oracle Database 23ai Overview
oracle4engineer
PRO
0
320
ロール・ツール群の開発 / Development of Roles and Tools
ks91
PRO
0
110
オープンソースのロボットソフトウェア「ROS」で地図作成を試してみた
miura55
0
180
シビックテックによる、社会と民主主義のアップデート
halsk
2
170
Featured
See All Featured
Understanding Cognitive Biases in Performance Measurement
bluesmoon
12
1.1k
Designing on Purpose - Digital PM Summit 2013
jponch
111
6.5k
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
221
21k
Debugging Ruby Performance
tmm1
70
11k
For a Future-Friendly Web
brad_frost
172
9k
Refactoring Trust on Your Teams (GOTO; Chicago 2020)
rmw
26
2.4k
Atom: Resistance is Futile
akmur
260
25k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
86
45k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
21
2k
How GitHub (no longer) Works
holman
305
140k
Building Applications with DynamoDB
mza
88
5.7k
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
sstephenson
155
14k
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を活用してはいかがでしょうか? おしまい