Enviar pesquisa
Carregar
Sphinxで社内勉強会(Git)の 資料を作ってみた
•
6 gostaram
•
13,911 visualizações
Taku SHIMIZU
Seguir
SphinxCon JP 2015での発表資料
Leia menos
Leia mais
Tecnologia
Denunciar
Compartilhar
Denunciar
Compartilhar
1 de 28
Baixar agora
Baixar para ler offline
Recomendados
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Takeshi Komiya
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Takeshi Komiya
ひとりsphinx
ひとりsphinx
(^-^) togakushi
APIドキュメントの話 #sphinxjp
APIドキュメントの話 #sphinxjp
Takeshi Komiya
How to spread reST and Sphinx
How to spread reST and Sphinx
Takanori Suzuki
JUS関西 Sphinxワークショップ@関西 Sphinx事例紹介
JUS関西 Sphinxワークショップ@関西 Sphinx事例紹介
kk_Ataka
Sphinxを使って本を書こう #pyconjp 2012
Sphinxを使って本を書こう #pyconjp 2012
Takayuki Shimizukawa
Oktavia全文検索エンジン - SphinxCon JP 2014
Oktavia全文検索エンジン - SphinxCon JP 2014
Yoshiki Shibukawa
Recomendados
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
Takeshi Komiya
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Sphinx ではじめるドキュメント生活 2013 #sphinxconjp
Takeshi Komiya
ひとりsphinx
ひとりsphinx
(^-^) togakushi
APIドキュメントの話 #sphinxjp
APIドキュメントの話 #sphinxjp
Takeshi Komiya
How to spread reST and Sphinx
How to spread reST and Sphinx
Takanori Suzuki
JUS関西 Sphinxワークショップ@関西 Sphinx事例紹介
JUS関西 Sphinxワークショップ@関西 Sphinx事例紹介
kk_Ataka
Sphinxを使って本を書こう #pyconjp 2012
Sphinxを使って本を書こう #pyconjp 2012
Takayuki Shimizukawa
Oktavia全文検索エンジン - SphinxCon JP 2014
Oktavia全文検索エンジン - SphinxCon JP 2014
Yoshiki Shibukawa
JUS関西 Sphinxワークショップ@関西 Sphinx紹介
JUS関西 Sphinxワークショップ@関西 Sphinx紹介
Takayuki Shimizukawa
BPstudy#64 ドキュメントを作りたくなってしまう魔法のツール Sphinx 2012年版
BPstudy#64 ドキュメントを作りたくなってしまう魔法のツール Sphinx 2012年版
Go Yamada
Sphinxで作る貢献しやすいドキュメント翻訳の仕組み
Sphinxで作る貢献しやすいドキュメント翻訳の仕組み
Takayuki Shimizukawa
SIerでもSphinxを使いたい! 前編
SIerでもSphinxを使いたい! 前編
kk_Ataka
個人的ドキュメンテーションツール トップ100
個人的ドキュメンテーションツール トップ100
Go Yamada
SIerでもSphinxを使いたい!総括
SIerでもSphinxを使いたい!総括
kk_Ataka
ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
Takayuki Shimizukawa
Sphinxの使い方事例
Sphinxの使い方事例
Go Yamada
Sphinx拡張 探訪 2014 #sphinxjp
Sphinx拡張 探訪 2014 #sphinxjp
Takeshi Komiya
手軽にメンテナンスできるドキュメントのヒミツ - blockdiag #odstudy 2011/07
手軽にメンテナンスできるドキュメントのヒミツ - blockdiag #odstudy 2011/07
Takeshi Komiya
Sphinx GO!!
Sphinx GO!!
Go Yamada
ドキュメントシステムはこれを使え2015年版
ドキュメントシステムはこれを使え2015年版
Keiichiro Shikano
マークアップ言語の拡張 メリットとデメリット #hankumi
マークアップ言語の拡張 メリットとデメリット #hankumi
Takeshi Komiya
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
Takeshi Komiya
SIerでもSphinxを使いたい! 後編
SIerでもSphinxを使いたい! 後編
kk_Ataka
社内のマニュアルをSphinxで作ってみた
社内のマニュアルをSphinxで作ってみた
Iosif Takakura
執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話
執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話
Takayuki Shimizukawa
Sphinx で手軽に作るドキュメント
Sphinx で手軽に作るドキュメント
Go Yamada
ドキュメントの話、しませんか? #428rk01
ドキュメントの話、しませんか? #428rk01
Takeshi Komiya
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
Takeshi Komiya
Sphinx HTML Theme Hacks
Sphinx HTML Theme Hacks
Shoji KUMAGAI
Markdownもはじめよう
Markdownもはじめよう
masayoshi takahashi
Mais conteúdo relacionado
Mais procurados
JUS関西 Sphinxワークショップ@関西 Sphinx紹介
JUS関西 Sphinxワークショップ@関西 Sphinx紹介
Takayuki Shimizukawa
BPstudy#64 ドキュメントを作りたくなってしまう魔法のツール Sphinx 2012年版
BPstudy#64 ドキュメントを作りたくなってしまう魔法のツール Sphinx 2012年版
Go Yamada
Sphinxで作る貢献しやすいドキュメント翻訳の仕組み
Sphinxで作る貢献しやすいドキュメント翻訳の仕組み
Takayuki Shimizukawa
SIerでもSphinxを使いたい! 前編
SIerでもSphinxを使いたい! 前編
kk_Ataka
個人的ドキュメンテーションツール トップ100
個人的ドキュメンテーションツール トップ100
Go Yamada
SIerでもSphinxを使いたい!総括
SIerでもSphinxを使いたい!総括
kk_Ataka
ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
Takayuki Shimizukawa
Sphinxの使い方事例
Sphinxの使い方事例
Go Yamada
Sphinx拡張 探訪 2014 #sphinxjp
Sphinx拡張 探訪 2014 #sphinxjp
Takeshi Komiya
手軽にメンテナンスできるドキュメントのヒミツ - blockdiag #odstudy 2011/07
手軽にメンテナンスできるドキュメントのヒミツ - blockdiag #odstudy 2011/07
Takeshi Komiya
Sphinx GO!!
Sphinx GO!!
Go Yamada
ドキュメントシステムはこれを使え2015年版
ドキュメントシステムはこれを使え2015年版
Keiichiro Shikano
マークアップ言語の拡張 メリットとデメリット #hankumi
マークアップ言語の拡張 メリットとデメリット #hankumi
Takeshi Komiya
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
Takeshi Komiya
SIerでもSphinxを使いたい! 後編
SIerでもSphinxを使いたい! 後編
kk_Ataka
社内のマニュアルをSphinxで作ってみた
社内のマニュアルをSphinxで作ってみた
Iosif Takakura
執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話
執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話
Takayuki Shimizukawa
Sphinx で手軽に作るドキュメント
Sphinx で手軽に作るドキュメント
Go Yamada
ドキュメントの話、しませんか? #428rk01
ドキュメントの話、しませんか? #428rk01
Takeshi Komiya
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
Takeshi Komiya
Mais procurados
(20)
JUS関西 Sphinxワークショップ@関西 Sphinx紹介
JUS関西 Sphinxワークショップ@関西 Sphinx紹介
BPstudy#64 ドキュメントを作りたくなってしまう魔法のツール Sphinx 2012年版
BPstudy#64 ドキュメントを作りたくなってしまう魔法のツール Sphinx 2012年版
Sphinxで作る貢献しやすいドキュメント翻訳の仕組み
Sphinxで作る貢献しやすいドキュメント翻訳の仕組み
SIerでもSphinxを使いたい! 前編
SIerでもSphinxを使いたい! 前編
個人的ドキュメンテーションツール トップ100
個人的ドキュメンテーションツール トップ100
SIerでもSphinxを使いたい!総括
SIerでもSphinxを使いたい!総括
ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
Sphinxの使い方事例
Sphinxの使い方事例
Sphinx拡張 探訪 2014 #sphinxjp
Sphinx拡張 探訪 2014 #sphinxjp
手軽にメンテナンスできるドキュメントのヒミツ - blockdiag #odstudy 2011/07
手軽にメンテナンスできるドキュメントのヒミツ - blockdiag #odstudy 2011/07
Sphinx GO!!
Sphinx GO!!
ドキュメントシステムはこれを使え2015年版
ドキュメントシステムはこれを使え2015年版
マークアップ言語の拡張 メリットとデメリット #hankumi
マークアップ言語の拡張 メリットとデメリット #hankumi
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
SIerでもSphinxを使いたい! 後編
SIerでもSphinxを使いたい! 後編
社内のマニュアルをSphinxで作ってみた
社内のマニュアルをSphinxで作ってみた
執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話
執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話
Sphinx で手軽に作るドキュメント
Sphinx で手軽に作るドキュメント
ドキュメントの話、しませんか? #428rk01
ドキュメントの話、しませんか? #428rk01
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
ドキュメントを加速する作画ツール Blockdiag 2011/07 #infotalk
Destaque
Sphinx HTML Theme Hacks
Sphinx HTML Theme Hacks
Shoji KUMAGAI
Markdownもはじめよう
Markdownもはじめよう
masayoshi takahashi
やりなおせる Git 入門
やりなおせる Git 入門
Tomohiko Himura
もしWordPressユーザーがGitを使ったら 〜WordPressテーマを共同編集しよう〜
もしWordPressユーザーがGitを使ったら 〜WordPressテーマを共同編集しよう〜
Takashi Uemura
ドキュメントを作りたくなってしまう魔法のツールSphinx
ドキュメントを作りたくなってしまう魔法のツールSphinx
Takayuki Shimizukawa
こわくない Git
こわくない Git
Kota Saito
Destaque
(6)
Sphinx HTML Theme Hacks
Sphinx HTML Theme Hacks
Markdownもはじめよう
Markdownもはじめよう
やりなおせる Git 入門
やりなおせる Git 入門
もしWordPressユーザーがGitを使ったら 〜WordPressテーマを共同編集しよう〜
もしWordPressユーザーがGitを使ったら 〜WordPressテーマを共同編集しよう〜
ドキュメントを作りたくなってしまう魔法のツールSphinx
ドキュメントを作りたくなってしまう魔法のツールSphinx
こわくない Git
こわくない Git
Semelhante a Sphinxで社内勉強会(Git)の 資料を作ってみた
勉強会旅人のススメ
勉強会旅人のススメ
and hyphen
僕らがQiitaをゴリゴリ書く理由
僕らがQiitaをゴリゴリ書く理由
Masayuki Hokimoto
TensorFlowをざっくりLTしてみた
TensorFlowをざっくりLTしてみた
Mitsuki Ogasahara
ゲームの裏側を支える人たちの裏側
ゲームの裏側を支える人たちの裏側
Riou Tomita
ユースケース駆動開発のワークショップやってみた!
ユースケース駆動開発のワークショップやってみた!
Tomoe Sawai
チーム開発をスムーズにするために何ができるか
チーム開発をスムーズにするために何ができるか
Takafumi Ikeda
Plone features and trends
Plone features and trends
Takanori Suzuki
アジャイル開発やってみた
アジャイル開発やってみた
Arata Fujimura
世界のSphinx事情 @ SphinxCon JP 2015
世界のSphinx事情 @ SphinxCon JP 2015
Takayuki Shimizukawa
エンジニアのためのアイコン作成勉強会
エンジニアのためのアイコン作成勉強会
Kazuaki KURIU
Python野球クラスタの紹介
Python野球クラスタの紹介
Shinichi Nakagawa
Members innovationlab#1
Members innovationlab#1
Sosuke Kimura
シリコンバレー 面接体験
シリコンバレー 面接体験
paiza
20150825.昇降式デスクの全面導入事例
20150825.昇降式デスクの全面導入事例
lalha
私と西新宿セミナールーム、そして…
私と西新宿セミナールーム、そして…
法林浩之
情報システム部がSplunk を使うとどうなるか?
情報システム部がSplunk を使うとどうなるか?
snicker_jp
セキュリティ&プログラミングキャンプに行こう!
セキュリティ&プログラミングキャンプに行こう!
Kenta USAMI
「Agileごっこ」で終わらせないために(仮)
「Agileごっこ」で終わらせないために(仮)
Taku Yajima
プログラミングのお勉強としてscratchをさわってみた
プログラミングのお勉強としてscratchをさわってみた
HirokiIwanaga
Sphinxの環境構築が再現できない問題をDockerで解決してみた
Sphinxの環境構築が再現できない問題をDockerで解決してみた
Study Group by SciencePark Corp.
Semelhante a Sphinxで社内勉強会(Git)の 資料を作ってみた
(20)
勉強会旅人のススメ
勉強会旅人のススメ
僕らがQiitaをゴリゴリ書く理由
僕らがQiitaをゴリゴリ書く理由
TensorFlowをざっくりLTしてみた
TensorFlowをざっくりLTしてみた
ゲームの裏側を支える人たちの裏側
ゲームの裏側を支える人たちの裏側
ユースケース駆動開発のワークショップやってみた!
ユースケース駆動開発のワークショップやってみた!
チーム開発をスムーズにするために何ができるか
チーム開発をスムーズにするために何ができるか
Plone features and trends
Plone features and trends
アジャイル開発やってみた
アジャイル開発やってみた
世界のSphinx事情 @ SphinxCon JP 2015
世界のSphinx事情 @ SphinxCon JP 2015
エンジニアのためのアイコン作成勉強会
エンジニアのためのアイコン作成勉強会
Python野球クラスタの紹介
Python野球クラスタの紹介
Members innovationlab#1
Members innovationlab#1
シリコンバレー 面接体験
シリコンバレー 面接体験
20150825.昇降式デスクの全面導入事例
20150825.昇降式デスクの全面導入事例
私と西新宿セミナールーム、そして…
私と西新宿セミナールーム、そして…
情報システム部がSplunk を使うとどうなるか?
情報システム部がSplunk を使うとどうなるか?
セキュリティ&プログラミングキャンプに行こう!
セキュリティ&プログラミングキャンプに行こう!
「Agileごっこ」で終わらせないために(仮)
「Agileごっこ」で終わらせないために(仮)
プログラミングのお勉強としてscratchをさわってみた
プログラミングのお勉強としてscratchをさわってみた
Sphinxの環境構築が再現できない問題をDockerで解決してみた
Sphinxの環境構築が再現できない問題をDockerで解決してみた
Último
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
Hiroshi Tomioka
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
iPride Co., Ltd.
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
iPride Co., Ltd.
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
CRI Japan, Inc.
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
NTT DATA Technology & Innovation
新人研修 後半 2024/04/26の勉強会で発表されたものです。
新人研修 後半 2024/04/26の勉強会で発表されたものです。
iPride Co., Ltd.
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
CRI Japan, Inc.
Último
(7)
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
業務で生成AIを活用したい人のための生成AI入門講座(社外公開版:キンドリルジャパン社内勉強会:2024年4月発表)
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その32024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
Amazon SES を勉強してみる その22024/04/26の勉強会で発表されたものです。
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
LoRaWANスマート距離検出センサー DS20L カタログ LiDARデバイス
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
NewSQLの可用性構成パターン(OCHaCafe Season 8 #4 発表資料)
新人研修 後半 2024/04/26の勉強会で発表されたものです。
新人研修 後半 2024/04/26の勉強会で発表されたものです。
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
LoRaWAN スマート距離検出デバイスDS20L日本語マニュアル
Sphinxで社内勉強会(Git)の 資料を作ってみた
1.
Sphinxで社内勉強会(Git)の 資料を作ってみた 清水 琢 (@takuan_osho) SphinxCon JP
2015
2.
自己紹介 清水 琢 (@takuan_osho) • 非IT系企業で社内システムのお守り •
いわゆる社内SE的な仕事をしている • Sphinxとの関わり • 初めて触れたのがSphinx翻訳ハッカソン(2011/2/12) • 「翻訳」の部分に惹かれて初参加 • それから色々なコミュニティに参加するようになる
3.
話すこと 今回話したいことはだいたい以下の通り。 • 事例紹介 • (Sphinxを使った時の)社内勉強会資料作成の考え方 •
「何故この選択をしたか?」ということについて
4.
話さないこと 今回触れないことは以下の通り。 • Sphinxの機能紹介・深い使い方
5.
目次 • 社内資料を作ることになった経緯 • 資料作成で一番重要視したこと •
Sphinxを使おうと思った理由 • Sphinxを使ってよかったこと • 上手くいかなかったこと • まとめ
6.
目次 • 社内資料を作ることになった経緯 • 資料作成で一番重要視したこと •
Sphinxを使おうと思った理由 • Sphinxを使ってよかったこと • 上手くいかなかったこと • まとめ
7.
社内資料を作ることになった経緯 Gitが新しく導入される。 • 日付バージョン管理辛いので導入された。 • チームメンバーの大半が Gitにそれほど精通していない =>
社内勉強会の必要性 • 上司から勉強会用の資料を 作るように言われる。
8.
目次 • 社内資料を作ることになった経緯 • 資料作成で一番重要視したこと •
Sphinxを使おうと思った理由 • Sphinxを使ってよかったこと • 上手くいかなかったこと • まとめ
9.
資料作成で一番重要視したこと 「何を書くか?」ではなく 「何を書かないか?」を考えて資料を作成。
10.
理由 題材がGitだから • 書こうと思えば書けることが多すぎる題材。
11.
資料を作る目的をはっきりさせる • 資料を作ることで「何を達成したいか?」に注目。 • 「業務で何とかついていける下地を作る」ことを目指す。 =>
前提知識の記述に集中 (=運用に関することは省く) • 振り返って見通せる量に抑えた説明 • CUIの基礎知識 • 必要最低限のコマンドの使い方 • (Gitの基本構造)
12.
実際の資料
13.
説明が足りないところについて • 世にあるGit関連の分かりやすい資料を活用 • 勉強会中の実演・実際の業務・口頭などで補足
14.
目次 • 社内資料を作ることになった経緯 • 資料作成で一番重要視したこと •
Sphinxを使おうと思った理由 • Sphinxを使ってよかったこと • 上手くいかなかったこと • まとめ
15.
Sphinxを使おうと思った理由 使い慣れていたことが最大の理由 以下の機能が有効活用できそうだと アタリがついていた • コマンドラインの記述が割と得意 • 見たままの感じ
+ コピペのしやすさ • (メンテしやすい)コミットログの図を描く • blockdiagを使用することを想定 • 完全に成功したとは言い難い
16.
目次 • 社内資料を作ることになった経緯 • 資料作成で一番重要視したこと •
Sphinxを使おうと思った理由 • Sphinxを使ってよかったこと • 上手くいかなかったこと • まとめ
17.
Sphinxを使ってよかったこと 目次の自動生成 • 資料の提示順を変更しやすい • 構造が固まりきっていない時は非常に有用 •
資料の入り口を示せば関連資料が全て見える • (関連する資料に限り)散逸しづらい • 章ごとにファイル分割して後でまとめても 自動で追従してくれる嬉しさ
18.
目次 • 社内資料を作ることになった経緯 • 資料作成で一番重要視したこと •
Sphinxを使おうと思った理由 • Sphinxを使ってよかったこと • 上手くいかなかったこと • まとめ
19.
上手くいかなかったこと コミットログをblockdiagで無理矢理描いたこと • 複雑でなければ描くのは可能 • しかし、メンテナンス性は悪い(と思う)
20.
生成した図
21.
生成した図のもとのコード blockdiag { default_group_color =
lightgreen default_fontsize = 15 default_shape = "circle" remote_firstlabel"A"]; remote_secondlabel"B"]; remote_thirdlabel"C"]; remote_master_branchlabel"* master", shape"roundedbox", colorpink; local_firstlabel"A"]; local_secondlabel"B"]; local_thirdlabel"C"]; local_master_branchlabel"* master", shape"roundedbox", colorpink; group { remote_first <- remote_second <- remote_third remote_third <- remote_master_branchdirnone styledashed } group { local_first <- local_second <- local_third local_third <- local_master_branchdirnone styledashed } }
22.
生成した図
23.
生成した図のもとのコード blockdiag { default_group_color =
lightgreen default_fontsize = 15 default_shape = "circle" remote_firstlabel"A"]; remote_secondlabel"B"]; remote_thirdlabel"C"]; remote_master_branchlabel"* master", shape"roundedbox", colorpink; local_firstlabel"A"]; local_secondlabel"B"]; local_thirdlabel"C"]; local_fourthlabel"D", color"orange"]; local_new_branchlabel"* featureadd-test-site", shape"roundedbox", colorpink; local_before_new_branchlabel"featureadd-test-site", shape"roundedbox", colorgray; local_master_branchlabel"master", shape"roundedbox", colorpink; group { remote_first <- remote_second <- remote_third remote_third <- remote_master_branchdirnone styledashed } group { local_first <- local_second <- local_third <- local_fourth local_fourth <- local_new_branchdirnone styledashed local_third <- local_before_new_branchdirnone styledashed local_third <- local_master_branchdirnone styledashed local_before_new_branch -> local_new_branchthick color"red"] } }
24.
上手くいかなかったこと メンテする機会を 無くしたつもりではあるけど 必要な時のメンテがつらい…
25.
上手くいかなかったこと 予想より各人のサポートする必要があったこと • 資料+αの練習だけでは畳の上の水練でしかない
26.
目次 • 社内資料を作ることになった経緯 • 資料作成で一番重要視したこと •
Sphinxを使おうと思った理由 • Sphinxを使ってよかったこと • 上手くいかなかったこと • まとめ
27.
まとめ 目的に合ったツール選択が重要 • Sphinxに拘らない • メンテナンス性も考慮に入れる 資料は「書いたら終わり」ではない •
書いた後のことも視野に入れた資料作りが大切
28.
質問
Baixar agora