[B! documentation][git] lizyのブックマーク

lizy id:lizy

documentationとgitに関するlizyのブックマーク (2)

Markdown と GitHub で社内規程を便利に管理 - クックパッド開発者ブログ
VP of Techno logy の星 (@kani_b) です。技術基盤や研究開発領域などを担当しつつ、社内の色々なことを技術の力でいい感じにする仕事をしています。セキュリティや AWS の話が好きです。さて、みなさんは、ご自身が勤務する会社の就業規則を読んだことはあるでしょうか。エンジニアに限らず、会社の全スタッフが仕事をする上で関わってくるのが、就業規則や情報セキュリティドキュメントなど、会社のルールや規程を記す文書です。特にセキュリティやインフラに携わるエンジニアは、その改訂も含め携わったことがある方もいるのではと思います。よくある文書管理こうした文書は、以下のように管理されていることが多いようです。ベースドキュメントは Word 保存時は PDF で保存版管理は Word の編集履歴 + PDF に保存する際のファイル名編集は担当部門, 担当者のみが行うかつての
lizy 2019/06/26
git

github

markdown

documentation
リンク
gitbookで設計書を作成したら最高だった話 - フォトシンスエンジニアブログ
こんにちは。Akerunエンジニアの @ishturk です。 Akerun Advent Calendarの記事です。今日は設計書の話です。設計書をどんなツールで書くかは、僕らソフトウェアエンジニアの尽きない悩み（楽しみ）ですね。最近はまったツールが最高に良かったので紹介させてください。僕のツールに求める要件は以下です。編集がカジュアルにできる UMLが書ける。あとから編集できる（画像での貼付けは編集できないのでNG）バージョンの管理ができる好きになれる（重要）変遷と pros/cons MS Word pros 良くも悪くもスタンダードなツールですね。だれでも編集できるのが強みです。 Visioと組み合わせれば、UMLも後から編集可能です cons Visioは標準にするには少々値が張ります。バイナリ形式なのでバージョン管理はしづらいです。ページが増えたり画像を貼
lizy 2017/12/26
git

gitbook

documentation
リンク
1