category

ドキュメントをGit管理にするかWikiにするか

2017-12-31

実装に関係しそうなドキュメント類はMarkdownかasciidocとかで管理するか、BacklogやRedmineとかのWikiで管理するのがいいんじゃないか、、、、とは思っているのだけれども。

gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ
http://akerun.hateblo.jp/entry/2017/12/26/110102

脱Word、脱Markdown、asciidocでドキュメント作成する際のアレコレ - Qiita
https://qiita.com/tamikura@github/items/5d3f62dae55617ee42bb

以前はmarkdownのファイルにしていた。

Google Docsでやってたこともあった。

最近はなんとなく Wiki に落ち着いてきてはいる。

Gitbookも便利だとは思うし、asciidoc もよいとはおもうのだけど。

実際に開発するメンバーとしてはどれが使いやすいんだろうなぁ。。。人それぞれだったりするしな。