File tree 2 files changed +7
-5
lines changed
2 files changed +7
-5
lines changed Original file line number Diff line number Diff line change @@ -9,7 +9,7 @@ PHPマニュアルのメンテナンスの前提となる基本知識や、修
9
9
10
10
## 基本知識
11
11
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) 世界中に公開されていくという具合です。
13
13
14
14
Docbook は、SGML 由来であることによって文書構造が複雑であることや、タグの構造が壊れてしまうと即ビルドが失敗してしまうなどの欠点によって、他のフォーマットに置き換えようという話がこれまで出なかったわけではありません。ですが、DocBook の多彩な表現力にとってかわることと、現在までの巨大な蓄積を効率的に置き換えられる代替案を誰かが示せない限り、移行していくことはないでしょう。
15
15
Original file line number Diff line number Diff line change @@ -10,7 +10,7 @@ PHPマニュアルのコミット権限を得たい方は、[こちらをまず
10
10
まずは PHPマニュアル をビルドする環境を整えなければ始まりません。
11
11
それを整える方法は [ PHPマニュアル のビルド方法] ( https://github.com/php/doc-ja/blob/master/README_Building_HOWTO.md ) を参照して下さい。
12
12
13
- ## 購読すべきメーリングリスト
13
+ ## 購読すべきメーリングリストやリポジトリ
14
14
15
15
PHPマニュアルのメンテナであれば、以下は最低限購読すべきです。
16
16
これらは、PHPマニュアル の更新のタイミングや、ドキュメントに関する議論の動向をウォッチするために必要です。
@@ -20,14 +20,16 @@ PHPマニュアルのメンテナであれば、以下は最低限購読すべ
20
20
- phpdoc-subscribe at lists.php.net にメールを出せば購読できます
21
21
* Documentation changes and commits (< ; doc-cvs at lists.php.net> ; )
22
22
- doc-cvs-subscribe at lists.php.net にメールを出せば購読できます
23
+ * GitHub 経由のコミットや、それにまつわるコメントなどもこのMLに forward されるので、英語版マニュアルの GitHub は watch する必要は現状ありません
23
24
* Documentation bugs (< ; doc-bugs at lists.php.net> ; )
24
25
- 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
+ * そうすることで、日本語版マニュアルに関する活動をすべてウォッチできます。
27
29
- phpdoc ja ML
28
30
* [ http://ml.php.gr.jp/mailman/listinfo/php-doc ] ( http://ml.php.gr.jp/mailman/listinfo/php-doc )
29
31
- 日本語のメーリングリストです
30
- - バグ報告を受け付けています
32
+ - バグ報告を受け付けていますが、過疎っています...
31
33
32
34
## PHPマニュアルの構造
33
35
You can’t perform that action at this time.
0 commit comments