マニュアル削除

Logパッケージのマニュアルがガサっと削除され、作者のサイトへの外部リンクに置き換えられた。
(詳細は、elfさんのところのビルド等を参照してください。 http://elf.no-ip.org/~elf/php/peardoc/en/package.logging.log.html )
これは、docbookのソースが更新されず、作者のサイトに詳しいマニュアルが掲載されているためだ。
しかし、この外部リンクを書く方法だと、翻訳を行うのが難しい。せっかくPEARマニュアルのdocbookに、翻訳のフレームワークがあるのにこれがまったく利用できなくなるのだ。
本来なら、作者(もしくは、パッケージのマニュアル製作担当者)に、マニュアルのdocbook化を働きかけるのが筋だと思う。PEARマニュアルに「マニュアルはこちら」なんていうリンクを書くのは応急処置であるはずだ。しかし、この働きかけが行われているのかどうかが見えない。

マニュアルのdocbook化が義務でない現在の状況において、作者のサイトへのリンクで代用する他の手はないだろうか?ぱっと思いつくところとして、

  • マニュアルがdocbook化されていないものはstableとできないようにする
  • リンク先のwebサイトをキャプチャーしたものをphp.netに置く(こうすれば翻訳対応が若干容易になる)

をあげておく。

この点に関してのphp.netでの議論について、過去ログをあさる必要があるようだ。まあ、少なくとも、最近は、作者のサイトへの外部リンク問題について議論された様子は無い。

#前半部分と同様の内容をMLに送ったがまともな英語をかけた自身が無いな。英語で議論する能力を高める必要あり<おれ。