プロジェクトの各種ドキュメントをExcelではなくMarkdownで作ってみた - 聞こえないJavaエンジニアが適当に書き連ねていく

これは何 プロジェクトの知見共有や手順書を共有する時に、Excelではなくてmarkdownで書いたWebsiteを使ったことの振り返り。 注意 Excelを全く使わなかったのではなく、主な資料をExcelではなくてWebsiteにした。補助資料をExcelで作ったものもある。 なぜExcelにしなかったのか 過去のプロジェクト経験を基にExcelを使うことのメリットとデメリットを比較した時、Excel以外の方法を試してみる価値はあると考えた。 Excelのメリット 画像の貼り付けや吹き出しの付与が簡単 文字の装飾が簡単 印刷することを想定しなければ、見た目を整えるのが非常に楽 Excelのデメリット ファイルをどこに置いてあるか探しにくい ファイル内部の文言検索がやりにくい 画像を大量に貼り付けるとファイルサイズが大きくなる 修正した時、差分の確認がほぼ不可能 Markdownで資料を作

[Soudai]

ドキュメントをメンテしていくならここが大事なんだよなぁ“これはプロジェクトメンバーにもよるので一概には言えないが、自分だけが書くのではなく、みんなでドキュメントを育てていく環境を作りたい。”

[Yaju3D]

Dokuwikiがアクセスを制限もあっていいと思うんですけどね、海外では普及しているのに日本だと認知度が低い。

[sgo2]

Excel最大のメリットは、スクリプト等で加工しやすい点だと思う。まぁデータソースは別に用意して、そこからドキュメントに差し込むやり方にすれば良いのだけど。

[kazkun]

どんな仕様書を書いているのかわからんが、文字が50%超えるような内容だったり、目次があったりするような内容ならExcelは選択肢から落とすべき。Wordも十分とは言えないが。