Re: JDDP page

[Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>]

遠藤です。

Taketoshi Sano <xlj06203@xxxxxxxxxxx> writes:

> ところで JDDP ページの再構成についてですが、先のメールに書いたような
> 
> 「一般利用者向け文書」 Top Directory の Docs.html{.ja,.en}
> 
> 「開発者向け文書」 ./devel/maintdocs.html{.ja,.en}
> 
> 「文書作成者向け資料」 ./devel/doc/index.html{.ja,.en}
> 
> に 3 分割して、相互にリンクする、という案についてはいかがでしょう ?

ちょっと気がついた点ですが、

* 「Top Directory の Docs.html」ですが、これ以上トップディレクトリにファ
   イルを置くのは好ましくないかと思います。

* 文書の管理という点では、Documents/ 以下にこれらのリンクもまとめた方が
  分かりやすいように思えます。

* 既にあちこちから現 JDDP ページにリンクが張られています。特に理由がな
  い限りは、それらのリンクが切れないように、すなわち JDDP (or 文書) の
  メインページの場所は Documents/index.html のままにしておくべきでしょ
  う。

* リンクする文書に関しては、最新のものと obsolete なもの (例えば hamm 
  インストールマニュアルなど) は区別した方がいいと思います。

* 文書を読むだけの人と翻訳や文書管理をする人で、かなりニーズが異なって
  くると思います。現 JDDP ページはどちらかというと後者向けのものだと思
  います。例えば単に文書を読むという人にとっては、翻訳者や管理者が誰か
  ということやその SGML ソースなどはどうでもいいことでしょう。その意味
  で、文書をとりあえず読みたいという人のためには、八田(ま)さんの 
  Debian BookShelf のようなものの方が喜ばれるのではないかなと思います。

* かつて八田(ま)さんが 未翻訳の各 DDP 文書を整理された記事を -doc に投
  稿されていました。未翻訳の文書でもユーザにとって有益なものはあるでしょ
  うし、翻訳メンバーの TODO としても役立つのではとか思ったりもします。

で、私の再編案なのですが、

Documents/

index 文書のページ (読むだけの人向けに特に重要な文書) 
      八田(ま)さんの Debian Book Shelf をとりあえず丸ごとコピー。

      * 佐野さんの Debian Tips のように正式には JDDP の文書でないもの
        もこちらにリンクを用意

jddp  JDDP 文書総目録  (翻訳/管理者向けに JDDP の全文書情報を網羅) 
      従来の details.html を改名

最初は単純にこれくらいにしといたほうがいいように思います。
これなら直ぐにできますし、なるべく早く最新の情報を提供するには、従来の
資産を活かして徐々に改良していった方が better でしょう。
一から再構成するとなると、やはり相当の時間がかかってしまいます。
そのうえで必要があれば、index および jddp を分割すればよいのではないで
しょうか。

-- 
Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>