[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[gentoojp-docs 851] ドキュメント整理

中野です

サーバー移転に合わせていくつかweb上のドキュメントも整理と見直しをして
いきたいと思っています。オリジナルドキュメントプロジェクトの方や他の方
も意見ください。


構成なのですが、www.gentoo.gr.jp の現在以下のようになってます。
(他にもいくつかあるのですがあまり使われてないので省略)

/jpmain
  GentooJPの運営に関するドキュメントや、各プロジェクトの説明など。

/jpdoc
  オリジナルドキュメントプロジェクトのドキュメント

/jpnews
  GentooJPで使っているニュース。本家ニュースの翻訳も含む。

/main
/doc
/proj
  本家のそれぞれのディレクトリと同じもの。ただし、現在は
www.gentoo.gr.jp上に本家のドキュメントは置いていないので未使用。
(正確にはwww.gentoo.orgへ飛ばしている。)



基本的な構成はそのままにするつもりですが、次のようにしようと思ってます。

・ /jpmain
現状と同じで、
「GentooJPの運営に関するドキュメントや、各プロジェクトの説明など」を置
く。ここに置くドキュメントはGentooJPとして作成するドキュメントだけにす
る。

具体的には、AuthorをGentooJPとして、編集をした人をEditorとして加えてい
けばいいのかな、と思っています。

それと誰が編集可能か、ということですが、基本的にGentooJP開発者の人なら
ばどのドキュメントも自由に編集可ということにしたいです。
(前からそのつもりなのですけどね。)

もちろん各プロジェクトのドキュメントはその担当の人が編集するものだと思
いますが、あんまり細かいルールを作ってもめんどくさくなるので、この辺は
うまいことやって行きましょう。

編集の仕方については、
https://www.gentoo.gr.jp/jpmain/developer.html
に少し書いておきました。このドキュメント自体も問題が無ければ近いうちに
ドラフトの文字を外します。

それとAuthorがGentooJPのドキュメントの連絡アドレスについてなのですが、
www@xxxxxxxxxxxxに統一したいと思っているのですが、どうでしょうか？

現在docs@xxxxxxxxxxxxとか[email protected]とか、色々あってなんか
ややこしいので、統一したいです。(一部、統一を開始しています。)

www@xxxxxxxxxxxx宛のメールは何人かの窓口の人に転送という形でいいと思い
ます。そしてその後各担当者へ連絡ということで。
(今のところ1年に数通なのでこの運用で十分可能だと思います。)


・ /jpdoc
オリジナルドキュメントプロジェクト作成のドキュメント。

ここのドキュメントは以前話にあったように、著者に責任を持ってもらうドキュ
メントを置くところです。これは今後もこのままでいいと思います。

で、ちょっとディレクトリの名前が紛らわしいので、
/jpdoc -> /contribution にしようと思うのですが、どうでしょうか？

それと現在/jpdocに入っているドキュメントで以下のものは/jpmainがふさわ
しいのではないかと思っています。

arukikata.html
gentoojp-tips.html
gentoo-glossary.html
gwn-history.html

編集されている方どう思いますか？
おぎうちさんと、なべけんさん、と
gentoo-glossary.htmlとgwn-history.htmlは担当者いないですね…。
gwn-history.htmlはGWN翻訳チームで担当してもらうのは難しいですか？


・ /jpnews
これはニュースのディレクトリなのですが、いろいろなニュースが混ざってし
まっていて、どうも管理がしにくいです。そこで以下の3つに分割しようと思っ
ています。
a
/jpnews/main
  GentooJPのニュース(依頼されて掲載するニュースも含む。このケース今ま
  で実績0ですが(^^;)
/jpnews/org
  本家の翻訳ニュース
/jpnews/gwn
  GWNのニュース。これはGWN翻訳プロジェクトと連動して。
  (今の本家のGWNのニュースなんか味気ないんでGWN翻訳チームのオリジナル
   でもいいかも、と少し思ったり)



そんな感じで、特に反対が無ければ順次やって行きます。

では。

-- 
Masatomo Nakano
http://www.madoro.org/