ドキュメント作成ツールの検討(Sphinx、ReVIEWとか) - wadahiroの日記
今後、マニュアルを書いてメンテナンスも継続的にしていく機会が丁度ありそうなので、現時点(2012/05/02)でどのツールが自分たちにフィットするか検討してみた。ツールの候補は以下。なお、過去の仕事ではWordとDocBookは経験あり。 Word DocBook Sphinx ReVIEW 前提 今回のマニュアル作成の前提は以下の通り。 複数人で作業し、1つのドキュメントを作成する(主に章単位でアサイン)。 特定顧客向けに部分的にカスタマイズして提供することもある。 外部向けのドキュメントなので、体裁はそれなりに整っている必要がある。 製品のエディションによってマニュアル構成が変わる(上位のエディションだと機能が増えるので章や節、説明が増えるなど)。 出力フォーマットはWordまたはHTMLならOK。PDFは必須ではない。 ドキュメント中に画像はそれなりにある。スクリーンキャプチャ、構成
Gradleを試行してみて - wadahiroの日記
ここ最近、ビルドツールにGradleを使ってます。Mavenは柔軟性がなく、複雑なことをやろうとすると結局maven-antrun-pluginでAntスクリプトをPOMに埋め込むなんてことになってしまうけど、Gradleはその点自由度はかなり高い。だってGroovyでそのまま書けますからね。 Antで書くくらいならGradleでいいんじゃない？と思ってます。理由は以下。 GradleだとAntタスクをそのまま使える。 ant.タスク名(…)でそのまま使えるので、Antになれた人でもとっつきやすい。独自に作りこんだAntタスク資産もそのまま使えますしね。 Groovyが書けるので、条件分岐や繰り返しも思いのまま。 ant-contribを使ってAntでもできるけど、XMLで書くくらないならGroovyでさくっと書いた方が楽だし見やすいでしょ。 Java、Groovyの色んな外部ライブラリも
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
