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
470
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
10
3.4k
n=1の経験が紡ぐエンジニアリングマネジメントの可能性 / The Possibilities of Engineering Management from n=1 Experiences
iwashi86
23
13k
エンジニアリングが好きな私たちのためのエンジニアリングマネジャー入門 / Engineering management for the rest of us
iwashi86
24
5.8k
エレガントパズル 30分 ダイジェスト版/ Elegant Puzzle 30min Digest
iwashi86
6
670
エレガントパズル エンジニアのマネジメントという難問にあなたはどう立ち向かうのか / Elegant Puzzle
iwashi86
18
4.6k
ベロシティを高く保つ仕事のすすめ方 / Maintaining a High Velocity as Productivity Hacks
iwashi86
54
21k
マネージャー&リーダー向け 社内トレーニング / Training of management and leadership for Stockmark
iwashi86
65
33k
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
実践アプリケーション設計 ②トランザクションスクリプトへの対応
recruitengineers
PRO
4
560
[CVPR2025論文読み会] Linguistics-aware Masked Image Modelingfor Self-supervised Scene Text Recognition
s_aiueo32
0
210
7月のガバクラ利用料が高かったので調べてみた
techniczna
3
590
AIとTDDによるNext.js「隙間ツール」開発の実践
makotot
6
720
DeNA での思い出 / Memories at DeNA
orgachem
PRO
3
1.7k
自社製CMSからmicroCMSへのリプレースがプロダクトグロースを加速させた話
nextbeatdev
0
150
モダンな現場と従来型の組織——そこに生じる "不整合" を解消してこそチームがパフォーマンスを発揮できる / Team-oriented Organization Design 20250825
mtx2s
6
650
広島銀行におけるAWS活用の取り組みについて
masakimori
0
140
TypeScript入門
recruitengineers
PRO
26
7.9k
JuniorからSeniorまで: DevOpsエンジニアの成長ロードマップ
yuriemori
1
240
知られざるprops命名の慣習 アクション編
uhyo
11
2.6k
【 LLMエンジニアがヒューマノイド開発に挑んでみた 】 - 第104回 Machine Learning 15minutes! Hybrid
soneo1127
0
130
Featured
See All Featured
It's Worth the Effort
3n
187
28k
Large-scale JavaScript Application Architecture
addyosmani
512
110k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
29
2.8k
Building a Scalable Design System with Sketch
lauravandoore
462
33k
How STYLIGHT went responsive
nonsquared
100
5.7k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
15
1.6k
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
30
9.6k
For a Future-Friendly Web
brad_frost
179
9.9k
Bash Introduction
62gerente
614
210k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
46
7.6k
Statistics for Hackers
jakevdp
799
220k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
23
1.4k
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を活用してはいかがでしょうか? おしまい