Sphinx + Jenkins で始めるドキュメントの継続的インテグレーション | TECHSCORE BLOG | TECHSCORE BLOG
はじめに はじめまして、白川です。 システム開発では、多かれ少なかれドキュメントを作成する必要があると思います。 Word、Excelによって作成することが大体と思いますが、いろいろと問題点があるな、と感じるようになりました。 文書自体の整形（改行や改ページ、インデント、文字サイズ）が大変 仕様書が膨大になってくると、何がどこにあるかわからなくなり、内容のメンテナンス・維持が難しくなる 結果として、内容の陳腐化を招いてしまい、 ドキュメントと現実の仕様に差異が発生して、役に立たないドキュメントとなってしまいます。 そうなると、システムの仕様を把握するために、ソースコードをみないといけなくなりますし、 知見が担当者に依存してしまい、担当者が不在になると分からないことが多くなってしまいます。 それを防ぐために、 Python製のドキュメントビルダーであるSphinxを現在試しています。 Sph
TECHSCORE - XML
数年前、XML ブームとも言える現象が起きました。 「アプリケーション間のデータ交換が簡単」「WEB時代の必須技術」などといわれ、XMLが技術者達の熱い期待を背負っていたときがありました。 ブームは一段落し、かつて程熱を帯びた言葉で語られなくなったXMLですが、では、XMLは廃れてしまったのでしょうか？ そうではありません。 着実に「基盤技術」として、あらゆるコンピュータシステムに実装されようとしています。 ここでは、XML, DTD, XML Schema などについて、詳しく説明します。 「XML関連アプリケーションを今すぐ実装しなければいけない」といった人には向かないかもしれません。 「XMLの本質を理解したい」「XMLについて、基礎からしっかり丁寧に習得したい」という人の力になれば、と思っています。 XML INDEX
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
