Help:編集ガイドライン

出典: ピッツバーグ便利帳

目次

編集ポリシー

  • すべての投稿情報に投稿者の実名を(苗字 Mon yyyy)の形で記載する。(苗字@所属 Mon yyyy)もOK。

編集フォーマット

今はページによってばらばらで統一されていませんが、目安としてはこんなフォーマットになります。

  • お店の名前などは基本的に見出し表示する(例:=== Suezo Cafe ===)。
    • ただし情報の量によって箇条書きか見出しかを選んでください。
  • 住所、郵便番号、電話番号、URLをわかる限り書く。
  • ページ間のリンクは積極的に(下の例だとスティーラーズ)。リンクの基準は、便利帳内にある項目以外でも構いません。
  • コメントは鍵括弧でくくって段落下げの箇条書き。
    • ただしコメントが長い場合は段落をさげなくても良いです。

もし編集のやり方がわからない場合は、「編集」タブの左隣の「ノート」にそのページについてのメモを残すことができるので、質問してください。コピペだけして、途中まで完成のときは「仕上げはまかせた」とでも書いておいてください。

方針の履歴

(Oct 2007) 方針:「おすすめ」情報のすばやい反映

ここ2,3年は投稿から便利帳リリースまで、半年~1年サイクル長いプロセスを経ていました。おおまかな流れはこんな具合です。

  1. 情報がpgh-jに投稿される
  2. 管理人会議でどれを載せるか話合う
  3. CVSから便利帳のLaTeXソースをチェックアウト
  4. LaTeXを編集
  5. LaTeXコンパイルして、正しく表示されるか確認
  6. CVSにチェックイン→便利帳リリースのスクリプトを走らせる

今までの方法は掲載内容について十分議論ができる一方、UNIXやLaTeXにある程度慣れている必要があったので手軽とはいえない体制でした。ソフトの設定だけで管理会が終わった事も・・・。

最近になってWikiが利用できるようになったので、すばやい情報の反映を目指して、導入しようということになりました。これにより、リリースサイクルは、

  1. 情報がpgh-jに投稿される
  2. 管理人がブラウザ上でWiki編集

と短くなります。将来的には管理人以外もWikiを編集するよう、体制作りを目指しています。

当面の目標は、現便利帳の項目をこの新便利帳に移すことです。みなさん、一緒にがんばりましょう。

(Oct 2002) 方針:ディレクトリから「おすすめ」への変化

便利帳誕生当初は、Web も今のようにポピュラーではなかったため、便利帳自体 がピッツバーグ情報のディレクトリという意味合いも持っていた。しかし現在ではwww.citysearch.comなど多くのピッツバーグ情報のディレクトリサイトが存在するので その意義は薄れている。また便利帳の肥大化→編集の負担の増大という問題もある。

そこで、便利帳のこれからの存在意義を、以下のように定義してみましょう。

  • ディレクトリとしての役目は他のWebサイトに任せる。
  • 「ピッツバーグにおける」「日本人が実際に使ってみてお勧めである」情報に的を絞る。
  • ポリシー
    • 匿名情報は便利帳に載せない
    • 原文をなるべくそのまま掲載する