Skip to content

Commit 5a5a36f

Browse files
committed
現状に合わせて、マニュアルのエコシステムに関する文書を更新
1 parent 0ba4c08 commit 5a5a36f

File tree

2 files changed

+7
-5
lines changed

2 files changed

+7
-5
lines changed

README_About_ThisManual.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ PHPマニュアルのメンテナンスの前提となる基本知識や、修
99

1010
## 基本知識
1111

12-
PHPマニュアル はPHP 5系から現在 (このエントリが更新されている時の最新は 8.0.11) に至るまでの歴史が蓄積されており、非常に巨大なマニュアルです。これは [DocBook](http://www.docbook.org/) を使って書かれており、それを適宜各ロケールの翻訳者がボランティアで英語以外の各国語に置き換えていっています。それが php.net のインフラでビルドされ、1日に1回 (正確には毎日午後3時 JST) 世界中に公開されていくという具合です。
12+
PHPマニュアル はPHP 7 系から現在 (このエントリが更新されている時の最新は 8.1.1) に至るまでの歴史が蓄積されており、非常に巨大なマニュアルです。これは [DocBook](http://www.docbook.org/) を使って書かれており、それを適宜各ロケールの翻訳者がボランティアで英語以外の各国語に置き換えていっています。それが php.net のインフラでビルドされ、1日に1回 (正確には毎日午後3時 JST) 世界中に公開されていくという具合です。
1313

1414
Docbook は、SGML 由来であることによって文書構造が複雑であることや、タグの構造が壊れてしまうと即ビルドが失敗してしまうなどの欠点によって、他のフォーマットに置き換えようという話がこれまで出なかったわけではありません。ですが、DocBook の多彩な表現力にとってかわることと、現在までの巨大な蓄積を効率的に置き換えられる代替案を誰かが示せない限り、移行していくことはないでしょう。
1515

README_Maintain_HOWTO.md

+6-4
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ PHPマニュアルのコミット権限を得たい方は、[こちらをまず
1010
まずは PHPマニュアル をビルドする環境を整えなければ始まりません。
1111
それを整える方法は [PHPマニュアル のビルド方法](https://github.com/php/doc-ja/blob/master/README_Building_HOWTO.md) を参照して下さい。
1212

13-
## 購読すべきメーリングリスト
13+
## 購読すべきメーリングリストやリポジトリ
1414

1515
PHPマニュアルのメンテナであれば、以下は最低限購読すべきです。
1616
これらは、PHPマニュアル の更新のタイミングや、ドキュメントに関する議論の動向をウォッチするために必要です。
@@ -20,14 +20,16 @@ PHPマニュアルのメンテナであれば、以下は最低限購読すべ
2020
- phpdoc-subscribe at lists.php.net にメールを出せば購読できます
2121
* Documentation changes and commits (<doc-cvs at lists.php.net>)
2222
- doc-cvs-subscribe at lists.php.net にメールを出せば購読できます
23+
* GitHub 経由のコミットや、それにまつわるコメントなどもこのMLに forward されるので、英語版マニュアルの GitHub は watch する必要は現状ありません
2324
* Documentation bugs (<doc-bugs at lists.php.net>)
2425
- doc-bugs-subscribe at lists.php.net にメールを出せば購読できます
25-
* 日本語の変更ログとコミット (<doc-ja at lists.php.net>)
26-
- doc-ja-subscribe at lists.php.net にメールを出せば購読できます
26+
* GitHub の 日本語版マニュアルの Watch
27+
- メンテナであれば、https://github.com/php/doc-ja`All Activity` を Watch するのが望ましいです。
28+
* そうすることで、日本語版マニュアルに関する活動をすべてウォッチできます。
2729
- phpdoc ja ML
2830
* [http://ml.php.gr.jp/mailman/listinfo/php-doc](http://ml.php.gr.jp/mailman/listinfo/php-doc)
2931
- 日本語のメーリングリストです
30-
- バグ報告を受け付けています
32+
- バグ報告を受け付けていますが、過疎っています...
3133

3234
## PHPマニュアルの構造
3335

0 commit comments

Comments
 (0)