「ArchWiki:貢献」の版間の差分
Kusakata.bot (トーク | 投稿記録) 細 (文字列「bbs.archlinuxjp.org」を「bbs.archlinux.jp」に置換) |
(→常に効果的に要約欄を使う: 訳出) |
||
(同じ利用者による、間の26版が非表示) | |||
1行目: | 1行目: | ||
[[Category:ArchWiki]] |
[[Category:ArchWiki]] |
||
+ | [[bs:ArchWiki:Contributing]] |
||
+ | [[el:ArchWiki:Contributing]] |
||
[[en:ArchWiki:Contributing]] |
[[en:ArchWiki:Contributing]] |
||
[[es:ArchWiki:Contributing]] |
[[es:ArchWiki:Contributing]] |
||
+ | [[pt:ArchWiki:Contributing]] |
||
[[ru:ArchWiki:Contributing]] |
[[ru:ArchWiki:Contributing]] |
||
[[zh-hans:ArchWiki:Contributing]] |
[[zh-hans:ArchWiki:Contributing]] |
||
+ | {{Related articles start}} |
||
+ | {{Related|ヘルプ:編集}} |
||
+ | {{Related|ヘルプ:スタイル}} |
||
+ | {{Related articles end}} |
||
ArchWiki はクリアで、総合的、そしてプロフェッショナルなドキュメンテーションのモデルになるよう努力しています。そのゴールを達成するために私達は合理的で機能的な方法で仕事を組織する必要があります: この記事ではあなたが貢献できる一番重要な仕事を模式的に説明します。 |
ArchWiki はクリアで、総合的、そしてプロフェッショナルなドキュメンテーションのモデルになるよう努力しています。そのゴールを達成するために私達は合理的で機能的な方法で仕事を組織する必要があります: この記事ではあなたが貢献できる一番重要な仕事を模式的に説明します。 |
||
これはコミュニティの取り組みですが、あなたが本気で仕事を引き受けてくれるなら、[[ArchWiki:メンテナンスチーム|wiki メンテナ]]として正当な地位に就くことになるでしょう。 |
これはコミュニティの取り組みですが、あなたが本気で仕事を引き受けてくれるなら、[[ArchWiki:メンテナンスチーム|wiki メンテナ]]として正当な地位に就くことになるでしょう。 |
||
+ | == 3つの基本的なルール == |
||
− | {{Note|記事を編集するときはいつも要約欄を使って下さい、[[ヘルプ:スタイル#編集内容の要約]]を見て下さい。複数の記事にまたがる大きな変更をしようとする場合は、まず適切な議論ページであなたの計画を検討してください。}} |
||
+ | 全ての貢献者は、初心者を含めて、他の wiki ユーザーへの[[行動規範|敬意]]の表れとして従うべきシンプルなルールがあります。[[#常に効果的に要約欄を使う]]・[[#一度で複雑な編集をしない]]・[[#議論ページでページの書き換えを知らせる]]の3つです。 |
||
− | == 必要条件 == |
||
+ | |||
+ | 全ての wiki の貢献者は、他のユーザーによって編集が早かれ遅かれ確認されることを想定・期待しなければなりません。そして、以下のルールに従って他のユーザーができるだけ早く簡単に確認できるようにして、他のユーザーのその権利を尊重しなければなりません。共同のソフトウェアプロジェクトに慣れている人は、wiki の編集の要約と git のコミットメッセージ・wiki の編集の差分と git の差分の類似点を簡単に理解できるでしょう。 |
||
+ | |||
+ | {{Warning|これらの基本的なルールを守らない編集や、合理的な努力として理解されない編集は、何の警告もなく完全に差し戻されるかもしれません。特に、人気のあるページに影響する場合はその可能性が高くなります。}} |
||
+ | |||
+ | === 常に効果的に要約欄を使う === |
||
+ | |||
+ | [https://meta.wikimedia.org/wiki/Help:Edit_summary/ja/ 編集の要約]は小さいテキストボックスで、ページの編集エリアの下、''{{int:savechanges}}'' や ''{{int:savearticle}}'' ボタンのすぐ上にあります。常に'''何を'''したか、'''なぜ'''したかを簡潔に書くことはとても重要です。要約欄では wiki の内部リンクが使えるため、関連するページや議論へのリンクに使ってください。同じように、関連する編集の差分や、フォーラムのスレッドやメーリングリストのような外部のリソースへの URL を貼り付けてください。 |
||
+ | |||
+ | 例えば文法や綴りの修正・文のシンプルな言葉遣いの変更など、[[Wikipedia:ja:Help:細部の編集|細部の編集]]の場合だけは、'''なぜ'''かの部分を省くことができます。同じように、新しい[[ヘルプ:議論|議論]]を始める場合や、議論に返信する場合は、要約欄に同じメッセージを書き直す必要はありません。 |
||
+ | |||
+ | {{Note|セクション見出しにある ''{{int:editsection}}'' をクリックするとき、要約欄に {{ic|/* ''セクション名'' */}} が事前に入力されます。これはコメントの構文ではありません。{{ic|/*}} と {{ic|*/}} の間にあるテキストは、ページのセクションへのリンクになります。編集の要約をその後に追記してください。}} |
||
+ | |||
+ | {{Tip| |
||
+ | * [[特別:最近の更新]]の編集の要約を見て、要約に何を書くべきかの発想を得ることができます。しかし、残念ながら全てのユーザーがこれらのガイドラインを知っているわけではないことに注意してください。 |
||
+ | * [[特別:差分/9791/next]] のようなリンクを使って差分へのクリックできる参照を作ることができます。構文の詳細は [[mw:Help:Diff/ja]] を参照してください。 |
||
+ | }} |
||
+ | |||
+ | === 一度で複雑な編集をしない === |
||
+ | |||
+ | ページに広範囲に渡る変更を加えたいときは、通常のページか議論ページかに関わらず、常にいくつかのシンプルな編集に分割してください。例えば、編集におけるいくつかの論理的な段階に従って分割することができます。疑わしいときは、結果の[[Wikipedia:ja:Help:差分|差分]]を確認するために ''差分を表示'' ボタンを押して、他のユーザーが理解できそうか確認してください。上で説明した要約もよく考えてください。複雑な差分を発生させる一般的な操作には以下のようなものがあります: |
||
+ | |||
+ | * ページ内でセクションを移動するのと同時にその内容を編集する。セクションを編集しないで移動して保存し、その後の編集で内容を変更することで解決できます。 |
||
+ | * 一度で複数のセクションを並べ替える。一度の編集で一つのセクションのみを移動することで解決できます。 |
||
+ | |||
+ | {{Note|このような方法は自然と[[特別:最近の更新]]の項目数を増やしますが、心配する必要はありません。ユーザーは ''個人設定 > 最近の更新 > 詳細の設定'' にある ''最近の更新とウォッチリストで、複数の変更をページごとにまとめる'' を有効にすることでリストをすっきりさせることができます。}} |
||
+ | |||
+ | === 議論ページでページの書き換えを知らせる === |
||
+ | |||
+ | ページや複数のページを抜本的に再構成・書き替えたいときは、始めに適切な議論ページで意図を説明して知らせることで、他の興味のあるユーザーの考えを共有するために返信する時間を作ることができます。 |
||
+ | |||
+ | 意図した変更を知らせることは、[[#常に効果的に要約欄を使う]]・[[#一度で複雑な編集をしない]]といった編集が免除'''されるわけではない'''ことに気を付けてください。 |
||
+ | |||
+ | == 最も重要なタスク == |
||
+ | |||
+ | このページではこれ以降、wiki に貢献するいろいろな方法を紹介します。しかし、それらの中で最も重要で検討すべきであることが1つあります。'''気に入ったページをウォッチリストに入れること'''です。記事を逆効果の編集から防いでください。 |
||
+ | |||
+ | 毎日 ArchWiki は様々なユーザーから[[ArchWiki:統計|数十件]]の編集を受けます。ほとんどの変更は改善です。しかし、1回だけの編集で、しばしば善意から、段落全体やセクションの意味を誤って編集したり、理由もなく全て削除したりすることもあります。これらに気付かれないままだと、それまでの編集者全員の価値のある編集が台なしになってしまいます。残念なことに、このようなことは想定するより頻繁に起きています。公式の wiki スタッフはできる限り逆効果の編集を抜き出して修正していますが、彼らに完全に頼るべきではありません。あなたと同じように wiki に使える時間は限られていますし、全ての内容について熟知しているわけではないため、おそらく彼らよりもあなたの方があなたの気に入ったページで扱われているトピックについて詳しいでしょう。一般的に、ユーザーが新しい内容を書くのに集中してそれまでの貢献に与える影響を気にしないとき、wiki は単に''機能しなくなります''。 |
||
+ | |||
+ | 幸い、あなたが貢献した・気に入った・詳しいページの編集を追うとても簡単な方法があります。ページの一番上に"ウォッチ"リンクがあり、クリックすることで[[特別:ウォッチリストの編集|あなたのウォッチリスト]]にそのページが追加されます。[[特別:ウォッチリスト]]や、[[特別:個人設定#mw-prefsection-personal-email|特別:個人設定#利用者情報]] の "メールの設定" からウォッチしているページが更新されたときにメールで通知するように設定することで、そのページの編集を追うことができるようになります。ウォッチリストに入っているページは[[特別:最近の更新]]では太字で強調されます。最後に、[[特別:個人設定#mw-prefsection-watchlist|特別:個人設定#ウォッチリスト]]でウォッチリストの設定を変更できます。設定によって、作成・編集したページを自動でウォッチするようにすることもできます。 |
||
+ | |||
+ | ウォッチリスト内のページが正確でない編集を受けたり、編集の内容が理解できなかったら、可能であれば修正するか、編集されたページか編集した人の[[ヘルプ:議論|議論ページ]]で議論を開始することが強く推奨されます。 |
||
+ | |||
+ | == 情報 == |
||
以下は貢献するために必要な情報を含むページの一覧です。 |
以下は貢献するために必要な情報を含むページの一覧です。 |
||
* [[ヘルプ:記事命名ガイドライン]]では効果的な記事の命名規則と wiki の可読性とナビゲーションを向上させるために考慮すべきことについて論じています。新しいページを作成する前に読んで下さい。 |
* [[ヘルプ:記事命名ガイドライン]]では効果的な記事の命名規則と wiki の可読性とナビゲーションを向上させるために考慮すべきことについて論じています。新しいページを作成する前に読んで下さい。 |
||
* [[ヘルプ:編集]]では広く使われている MediaWiki のマークアップと ArchWiki 特有のガイドラインを説明してます。全ての編集者が読むべきページです。 |
* [[ヘルプ:編集]]では広く使われている MediaWiki のマークアップと ArchWiki 特有のガイドラインを説明してます。全ての編集者が読むべきページです。 |
||
+ | * [[ヘルプ:議論]]では議論ページで議論する方法を説明しています。 |
||
* [[ヘルプ:スタイル]]には ArchWiki の記事の文体の標準化のためのガイドラインがあります。 |
* [[ヘルプ:スタイル]]には ArchWiki の記事の文体の標準化のためのガイドラインがあります。 |
||
* [[ヘルプ:カテゴリ]]ではページカテゴリの設定方法や、存在しないカテゴリの作成方法、他のカテゴリにページを移動する方法を説明しています。 |
* [[ヘルプ:カテゴリ]]ではページカテゴリの設定方法や、存在しないカテゴリの作成方法、他のカテゴリにページを移動する方法を説明しています。 |
||
* [[ArchWiki 翻訳チーム]]には手順を追って新しい翻訳ページを作成するイントロダクションがあります。ページをあなたの言語に翻訳するときに参照してください。 |
* [[ArchWiki 翻訳チーム]]には手順を追って新しい翻訳ページを作成するイントロダクションがあります。ページをあなたの言語に翻訳するときに参照してください。 |
||
* [[ヘルプ:i18n]] では ArchWiki の国際化と地域化についての包括的なガイドラインが書かれています。 |
* [[ヘルプ:i18n]] では ArchWiki の国際化と地域化についての包括的なガイドラインが書かれています。 |
||
+ | * [[ヘルプ:操作手順]] は複雑な操作のための便利なチェックリストです。 |
||
− | 全てのヘルプ記事は[[:Category:ヘルプ|ヘルプカテゴリ]]で見てください。 |
||
+ | 全てのヘルプ記事は[[:カテゴリ:ヘルプ]]で見てください。 |
||
− | |||
− | == 簡単に初められる仕事 == |
||
− | 以下は難しい仕事に移る前にあなたが始めることができる簡単な仕事です。 |
||
− | |||
− | === 二重リダイレクトの修正 === |
||
− | # [[ヘルプ:編集#リダイレクト|このセクション]]を読んでリダイレクトが何か理解しましょう。 |
||
− | # [[特別:二重リダイレクト]]をチェックして二重リダイレクトが存在しないか確認します。 |
||
− | # 例えば、{{ic|Pastebin クライアント (編集) → 一般的なアプリケーション → アプリケーション一覧}} とある場合、これは [[Pastebin クライアント]]が[[一般的なアプリケーション]]にリダイレクトされ、[[一般的なアプリケーション]]は[[アプリケーション一覧]]にリダイレクトされることを意味しています。従って、[[Pastebin クライアント]]は二重リダイレクトです。 |
||
− | # 修正するには、[[Pastebin クライアント]]を編集して {{ic|<nowiki>#REDIRECT [[一般的なアプリケーション]]</nowiki>}} を {{ic|<nowiki>#REDIRECT [[アプリケーション一覧]]</nowiki>}} に変更して中間ページを排除します。 |
||
− | # 編集要約欄に "{{ic|<nowiki>二重リダイレクトの修正</nowiki>}}" などと入力して保存してください。 |
||
− | |||
− | ===内部リンクの使用=== |
||
− | ArchWiki がリンク先の外部リンクを内部リンクで置き換える。 |
||
− | * [https://wiki.archlinux.org/index.php?title=Special%3ALinkSearch&target=http%3A%2F%2Fwiki.archlinux.org http リンク]のリスト |
||
− | * [https://wiki.archlinux.org/index.php?title=Special%3ALinkSearch&target=https%3A%2F%2Fwiki.archlinux.org https リンク]のリスト |
||
==作成== |
==作成== |
||
39行目: | 77行目: | ||
大きなプロジェクトの調整を手伝いたいならば[[ArchWiki:管理者|管理者]]に申告してください。 |
大きなプロジェクトの調整を手伝いたいならば[[ArchWiki:管理者|管理者]]に申告してください。 |
||
+ | |||
+ | [[ヘルプ:編集#ページの作成]]ではメインの名前空間に新しいページを作成する手順を説明しています。 |
||
+ | |||
+ | wiki のサブページ機能(ページ/サブページ)はユーザーページでも利用可能です。ユーザーページの空のサブページを使って下書きを作ることができます。ユーザーページはカテゴリに含めてはいけないことに気を付けてください。その他の全ての機能は利用可能です。下書きが完成したら、単にサブページを新しい名前に移動することができます。移動した後、記事の状態テンプレートを追加してください。状態テンプレートの理由を適切に書くほど、他のユーザーがあなたと一緒に wiki を [[#整備]] するのが簡単になります。 |
||
==整備== |
==整備== |
||
44行目: | 86行目: | ||
* [[ArchWiki:リクエスト|リクエスト]]を満たすのを手伝う。 |
* [[ArchWiki:リクエスト|リクエスト]]を満たすのを手伝う。 |
||
− | * [[ |
+ | * [[:カテゴリ:Template:Expansion が使われているページ|未完成]]または[[:カテゴリ:Template:Style が使われているページ|中身が乏しい]]記事を拡充する。 |
− | * [[ |
+ | * [[:カテゴリ:Template:Accuracy が使われているページ|不正確]]だったり[[:カテゴリ:Template:Out of date が使われているページ|古くなった]]内容を修正したり、綴り・文法・言葉遣い・[[スタイル]]を校正する。 |
+ | |||
− | * フォーラムから適切な質問を [[FAQ]] に更新して使われなくなった質問を削除する。 |
||
+ | === Arch を使っていないユーザー === |
||
+ | |||
+ | 誰でも[[ヘルプ:編集#アカウントの作成|アカウントを作成]]できます。Arch を使っていないユーザーは、Arch Linux にも適用できることが確かである限り、他の Linux ディストリビューションや OS に適用できる内容を貢献しても構いません。具体的には、記事は Arch のユーザーに向けて書かれなければいけません。つまり: |
||
+ | |||
+ | * 他の Linux ディストリビューションや OS に特有のコメントを追加しないでください。例えば、Fedora ユーザーが [[systemd]] ページに貢献するのは構いませんが、新しく追加された内容が Fedora でも動くということに言及するのは無関係として削除されます。 |
||
+ | * Arch 特有の慣習・用語・ユーティリティをより広い範囲の OS に適用できる代替に置き換えないでください。 |
||
==保全== |
==保全== |
||
− | * [[ |
+ | * [[特別:最近の更新|最近の更新]]のパトロール、[[ヘルプ:操作手順#一般的な問題と解決法|問題のある編集]]の修正、報告 |
− | * {{Ic|<nowiki>{{ |
+ | * {{Ic|<nowiki>{{Out of date}}</nowiki>}}, {{Ic|<nowiki>{{Accuracy}}</nowiki>}}, {{Ic|<nowiki>{{Remove}}</nowiki>}}, {{Ic|<nowiki>{{Archive}}</nowiki>}} など適切な[[ヘルプ:テンプレート#記事の状態テンプレート|記事の状態テンプレート]]を使って記事のフラグを立てる。 |
− | * 記事をあなたのウォッチリストに追加して記事を逆効果の編集から防ぐ。 |
+ | * 記事をあなたのウォッチリストに追加して記事を逆効果の編集から防ぐ。([[#最も重要なタスク]]) |
− | * 様々なページの議論に参加する: ほとんどのユーザーが興味を持つのは議論の最新の投稿でありそれは[https://wiki.archlinux. |
+ | * 様々なページの議論に参加する: ほとんどのユーザーが興味を持つのは議論の最新の投稿でありそれは[https://wiki.archlinux.jp/index.php?namespace=1&title=Special%3ARecentChanges このリンク]から見ることができます。メンテナンスの投稿は [https://wiki.archlinux.jp/index.php?namespace=13&title=Special%3ARecentChanges], [https://wiki.archlinux.jp/index.php?namespace=11&title=Special%3ARecentChanges], [https://wiki.archlinux.jp/index.php?namespace=5&title=Special%3ARecentChanges], [https://wiki.archlinux.jp/index.php?namespace=15&title=Special%3ARecentChanges] にリストされています。 |
==編成== |
==編成== |
||
[[目次|カテゴリツリー]]を実現・改善する全ての wiki メンテナにとって記事の整理・カテゴライズ・移動は主要な仕事になります。 |
[[目次|カテゴリツリー]]を実現・改善する全ての wiki メンテナにとって記事の整理・カテゴライズ・移動は主要な仕事になります。 |
||
− | * 重複するページを削除・[[ |
+ | * 重複するページを削除・[[:カテゴリ:Template:Merge が使われているページ|結合]]する。 |
* wiki の[[目次|ナビゲーション]]を改善する。 |
* wiki の[[目次|ナビゲーション]]を改善する。 |
||
− | * [[ |
+ | * [[特別:カテゴリ未導入のページ|カテゴリ分類されていないページ]]や[[特別:カテゴリ未導入のカテゴリ|カテゴリ分類されていないカテゴリ]]をカテゴリに入れたり[[特別:存在しないカテゴリへのリンク|カテゴリページが存在しないカテゴリ]]のカテゴリページを作る。[[ヘルプ:スタイル#カテゴリ]]や[[ヘルプ:スタイル#カテゴリページ]]を見て下さい。 |
− | * [[ |
+ | * [[特別:迷子のリダイレクト|迷子]]や[[特別:二重リダイレクト|二重]]のリダイレクトを修正する。 [[:カテゴリ:Template:Redirect が使われているページ|提案されたリダイレクト]]を適用するか議論してください。 |
− | * 整理に役立つ他のツールは [[ |
+ | * 整理に役立つ他のツールは [[特別:特別ページ一覧]] を見て下さい。 |
==翻訳== |
==翻訳== |
||
− | 翻訳を[[ |
+ | 翻訳を[[:カテゴリ:Template:Translateme が使われているページ|追加]]したり[[:カテゴリ:Template:Bad translation が使われているページ|改善]]する; 翻訳は互いに同期するようにしてください。いくつかの言語では効率的に記事の翻訳をまとめるための共同プロジェクトを始めています (下のリストを見て下さい)。あなたの言語の翻訳チームに参加したり、記事の翻訳を始めるつもりであることを知らせることを考えてみて下さい。 |
+ | |||
− | * [[ArchWiki 翻訳チーム]] |
||
+ | * [[:en:ArchWiki:Translation Team]] |
||
+ | * [[:en:ArchWiki:Translation Team (Català)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Español)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Esperanto)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Français)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Hrvatski)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Italiano)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Nederlands)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Polski)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Português)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Slovenský)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Česky)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Ελληνικά)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Русский)]] |
||
+ | * [[:en:ArchWiki:Translation Team (Українська)]] |
||
+ | * [[:en:ArchWiki:Translation Team (العربية)]] |
||
+ | * [[:en:ArchWiki:Translation Team (正體中文)]] |
||
+ | * [[:en:ArchWiki:Translation Team (简体中文)]] |
||
+ | * [[:en:ArchWiki:Translation Team (한국어)]] |
||
+ | |||
外部 wiki を使っている言語もあります、外部 wiki では翻訳に異なった手順が必要かもしれません。外部 wiki のリストは [[ヘルプ:i18n]] にあります。 |
外部 wiki を使っている言語もあります、外部 wiki では翻訳に異なった手順が必要かもしれません。外部 wiki のリストは [[ヘルプ:i18n]] にあります。 |
||
+ | |||
+ | === 特別なメッセージの翻訳 === |
||
+ | |||
+ | Arch Wiki にはいくつか特別なメッセージが使われています。次のリンクからその翻訳を提供してください: |
||
+ | |||
+ | * Also in (カテゴリツリー内のメッセージ): [[:en:Talk:Table of contents#"also in" translations]] |
||
+ | * Talkpagetext : [[:en:MediaWiki talk:Talkpagetext#Talkpagetext translation]] |
||
==ブレーンストーミング== |
==ブレーンストーミング== |
||
− | どこから始めたらいいかわからなかったり、他の人が書いたものを編集するのに気が引けるのなら、[https://bbs.archlinux.jp/ Arch Linux フォーラム] の [https://bbs.archlinux.jp/viewforum.php?id=13 フォーラム & Wiki の話題] セクションにアイデアや提案を投稿して貢献することもできます。 |
+ | リアルタイムに他のユーザーと一緒に貢献するために、公式の [[:en:ArchWiki:IRC|#archlinux-wiki]] IRC チャンネルがあります。どこから始めたらいいかわからなかったり、他の人が書いたものを編集するのに気が引けるのなら、[https://bbs.archlinux.jp/ Arch Linux フォーラム] の [https://bbs.archlinux.jp/viewforum.php?id=13 フォーラム & Wiki の話題] セクションにアイデアや提案を投稿して貢献することもできます。 |
==バックエンドメンテナンス== |
==バックエンドメンテナンス== |
||
− | [https://bugs.archlinux.org/ Arch Linux Bugtracker] を使ってバグを報告したり MediaWiki のコードベースにフィックスや改善を加える。 |
+ | [https://bugs.archlinux.org/ Arch Linux Bugtracker] を使ってバグを報告したり MediaWiki のコードベースにフィックスや改善を加える。ArchWiki のバックエンドの[https://bugs.archlinux.org/index.php?string={wiki}&project=0 報告されたバグのリスト] も参照してください。 |
+ | |||
+ | == 異議申し立て == |
||
+ | |||
+ | wiki が管理される方法についての''一般的な''否定的な意見や不満があれば、[[ArchWiki・トーク:メンテナンスチーム]] にメッセージを残してください。もちろん、丁寧な口調で不満を言うことが可能であると述べる必要はありませんよ。 :) ''特定の''編集やページについての不満には、もっと適切な議論ページを使ってください。 |
||
+ | |||
+ | {{TranslationStatus|ArchWiki:Contributing|2022-06-07|719811}} |
2022年6月8日 (水) 09:09時点における最新版
ArchWiki はクリアで、総合的、そしてプロフェッショナルなドキュメンテーションのモデルになるよう努力しています。そのゴールを達成するために私達は合理的で機能的な方法で仕事を組織する必要があります: この記事ではあなたが貢献できる一番重要な仕事を模式的に説明します。
これはコミュニティの取り組みですが、あなたが本気で仕事を引き受けてくれるなら、wiki メンテナとして正当な地位に就くことになるでしょう。
目次
3つの基本的なルール
全ての貢献者は、初心者を含めて、他の wiki ユーザーへの敬意の表れとして従うべきシンプルなルールがあります。#常に効果的に要約欄を使う・#一度で複雑な編集をしない・#議論ページでページの書き換えを知らせるの3つです。
全ての wiki の貢献者は、他のユーザーによって編集が早かれ遅かれ確認されることを想定・期待しなければなりません。そして、以下のルールに従って他のユーザーができるだけ早く簡単に確認できるようにして、他のユーザーのその権利を尊重しなければなりません。共同のソフトウェアプロジェクトに慣れている人は、wiki の編集の要約と git のコミットメッセージ・wiki の編集の差分と git の差分の類似点を簡単に理解できるでしょう。
常に効果的に要約欄を使う
編集の要約は小さいテキストボックスで、ページの編集エリアの下、変更を保存 や ページを保存 ボタンのすぐ上にあります。常に何をしたか、なぜしたかを簡潔に書くことはとても重要です。要約欄では wiki の内部リンクが使えるため、関連するページや議論へのリンクに使ってください。同じように、関連する編集の差分や、フォーラムのスレッドやメーリングリストのような外部のリソースへの URL を貼り付けてください。
例えば文法や綴りの修正・文のシンプルな言葉遣いの変更など、細部の編集の場合だけは、なぜかの部分を省くことができます。同じように、新しい議論を始める場合や、議論に返信する場合は、要約欄に同じメッセージを書き直す必要はありません。
一度で複雑な編集をしない
ページに広範囲に渡る変更を加えたいときは、通常のページか議論ページかに関わらず、常にいくつかのシンプルな編集に分割してください。例えば、編集におけるいくつかの論理的な段階に従って分割することができます。疑わしいときは、結果の差分を確認するために 差分を表示 ボタンを押して、他のユーザーが理解できそうか確認してください。上で説明した要約もよく考えてください。複雑な差分を発生させる一般的な操作には以下のようなものがあります:
- ページ内でセクションを移動するのと同時にその内容を編集する。セクションを編集しないで移動して保存し、その後の編集で内容を変更することで解決できます。
- 一度で複数のセクションを並べ替える。一度の編集で一つのセクションのみを移動することで解決できます。
議論ページでページの書き換えを知らせる
ページや複数のページを抜本的に再構成・書き替えたいときは、始めに適切な議論ページで意図を説明して知らせることで、他の興味のあるユーザーの考えを共有するために返信する時間を作ることができます。
意図した変更を知らせることは、#常に効果的に要約欄を使う・#一度で複雑な編集をしないといった編集が免除されるわけではないことに気を付けてください。
最も重要なタスク
このページではこれ以降、wiki に貢献するいろいろな方法を紹介します。しかし、それらの中で最も重要で検討すべきであることが1つあります。気に入ったページをウォッチリストに入れることです。記事を逆効果の編集から防いでください。
毎日 ArchWiki は様々なユーザーから数十件の編集を受けます。ほとんどの変更は改善です。しかし、1回だけの編集で、しばしば善意から、段落全体やセクションの意味を誤って編集したり、理由もなく全て削除したりすることもあります。これらに気付かれないままだと、それまでの編集者全員の価値のある編集が台なしになってしまいます。残念なことに、このようなことは想定するより頻繁に起きています。公式の wiki スタッフはできる限り逆効果の編集を抜き出して修正していますが、彼らに完全に頼るべきではありません。あなたと同じように wiki に使える時間は限られていますし、全ての内容について熟知しているわけではないため、おそらく彼らよりもあなたの方があなたの気に入ったページで扱われているトピックについて詳しいでしょう。一般的に、ユーザーが新しい内容を書くのに集中してそれまでの貢献に与える影響を気にしないとき、wiki は単に機能しなくなります。
幸い、あなたが貢献した・気に入った・詳しいページの編集を追うとても簡単な方法があります。ページの一番上に"ウォッチ"リンクがあり、クリックすることであなたのウォッチリストにそのページが追加されます。特別:ウォッチリストや、特別:個人設定#利用者情報 の "メールの設定" からウォッチしているページが更新されたときにメールで通知するように設定することで、そのページの編集を追うことができるようになります。ウォッチリストに入っているページは特別:最近の更新では太字で強調されます。最後に、特別:個人設定#ウォッチリストでウォッチリストの設定を変更できます。設定によって、作成・編集したページを自動でウォッチするようにすることもできます。
ウォッチリスト内のページが正確でない編集を受けたり、編集の内容が理解できなかったら、可能であれば修正するか、編集されたページか編集した人の議論ページで議論を開始することが強く推奨されます。
情報
以下は貢献するために必要な情報を含むページの一覧です。
- ヘルプ:記事命名ガイドラインでは効果的な記事の命名規則と wiki の可読性とナビゲーションを向上させるために考慮すべきことについて論じています。新しいページを作成する前に読んで下さい。
- ヘルプ:編集では広く使われている MediaWiki のマークアップと ArchWiki 特有のガイドラインを説明してます。全ての編集者が読むべきページです。
- ヘルプ:議論では議論ページで議論する方法を説明しています。
- ヘルプ:スタイルには ArchWiki の記事の文体の標準化のためのガイドラインがあります。
- ヘルプ:カテゴリではページカテゴリの設定方法や、存在しないカテゴリの作成方法、他のカテゴリにページを移動する方法を説明しています。
- ArchWiki 翻訳チームには手順を追って新しい翻訳ページを作成するイントロダクションがあります。ページをあなたの言語に翻訳するときに参照してください。
- ヘルプ:i18n では ArchWiki の国際化と地域化についての包括的なガイドラインが書かれています。
- ヘルプ:操作手順 は複雑な操作のための便利なチェックリストです。
全てのヘルプ記事はカテゴリ:ヘルプで見てください。
作成
ArchWiki の方針(フィロソフィー)を理解して他の人が読みたいと思うものは何か考えて下さい (ArchWiki:リクエスト にアイデアがあります)。上で述べたようにこの wiki ではとても広い範囲をカバーしています。
大きなプロジェクトの調整を手伝いたいならば管理者に申告してください。
ヘルプ:編集#ページの作成ではメインの名前空間に新しいページを作成する手順を説明しています。
wiki のサブページ機能(ページ/サブページ)はユーザーページでも利用可能です。ユーザーページの空のサブページを使って下書きを作ることができます。ユーザーページはカテゴリに含めてはいけないことに気を付けてください。その他の全ての機能は利用可能です。下書きが完成したら、単にサブページを新しい名前に移動することができます。移動した後、記事の状態テンプレートを追加してください。状態テンプレートの理由を適切に書くほど、他のユーザーがあなたと一緒に wiki を #整備 するのが簡単になります。
整備
内容の編集、校正、保守はどの wiki でも果てしのない (never-ending) 作業になります。もしあなたが手伝っていただけるのならば、アカウントを登録してあなたの魔法を使い始めて下さい。
Arch を使っていないユーザー
誰でもアカウントを作成できます。Arch を使っていないユーザーは、Arch Linux にも適用できることが確かである限り、他の Linux ディストリビューションや OS に適用できる内容を貢献しても構いません。具体的には、記事は Arch のユーザーに向けて書かれなければいけません。つまり:
- 他の Linux ディストリビューションや OS に特有のコメントを追加しないでください。例えば、Fedora ユーザーが systemd ページに貢献するのは構いませんが、新しく追加された内容が Fedora でも動くということに言及するのは無関係として削除されます。
- Arch 特有の慣習・用語・ユーティリティをより広い範囲の OS に適用できる代替に置き換えないでください。
保全
- 最近の更新のパトロール、問題のある編集の修正、報告
{{Out of date}}
,{{Accuracy}}
,{{Remove}}
,{{Archive}}
など適切な記事の状態テンプレートを使って記事のフラグを立てる。- 記事をあなたのウォッチリストに追加して記事を逆効果の編集から防ぐ。(#最も重要なタスク)
- 様々なページの議論に参加する: ほとんどのユーザーが興味を持つのは議論の最新の投稿でありそれはこのリンクから見ることができます。メンテナンスの投稿は [1], [2], [3], [4] にリストされています。
編成
カテゴリツリーを実現・改善する全ての wiki メンテナにとって記事の整理・カテゴライズ・移動は主要な仕事になります。
- 重複するページを削除・結合する。
- wiki のナビゲーションを改善する。
- カテゴリ分類されていないページやカテゴリ分類されていないカテゴリをカテゴリに入れたりカテゴリページが存在しないカテゴリのカテゴリページを作る。ヘルプ:スタイル#カテゴリやヘルプ:スタイル#カテゴリページを見て下さい。
- 迷子や二重のリダイレクトを修正する。 提案されたリダイレクトを適用するか議論してください。
- 整理に役立つ他のツールは 特別:特別ページ一覧 を見て下さい。
翻訳
翻訳を追加したり改善する; 翻訳は互いに同期するようにしてください。いくつかの言語では効率的に記事の翻訳をまとめるための共同プロジェクトを始めています (下のリストを見て下さい)。あなたの言語の翻訳チームに参加したり、記事の翻訳を始めるつもりであることを知らせることを考えてみて下さい。
- en:ArchWiki:Translation Team
- en:ArchWiki:Translation Team (Català)
- en:ArchWiki:Translation Team (Español)
- en:ArchWiki:Translation Team (Esperanto)
- en:ArchWiki:Translation Team (Français)
- en:ArchWiki:Translation Team (Hrvatski)
- en:ArchWiki:Translation Team (Italiano)
- en:ArchWiki:Translation Team (Nederlands)
- en:ArchWiki:Translation Team (Polski)
- en:ArchWiki:Translation Team (Português)
- en:ArchWiki:Translation Team (Slovenský)
- en:ArchWiki:Translation Team (Česky)
- en:ArchWiki:Translation Team (Ελληνικά)
- en:ArchWiki:Translation Team (Русский)
- en:ArchWiki:Translation Team (Українська)
- en:ArchWiki:Translation Team (العربية)
- en:ArchWiki:Translation Team (正體中文)
- en:ArchWiki:Translation Team (简体中文)
- en:ArchWiki:Translation Team (한국어)
外部 wiki を使っている言語もあります、外部 wiki では翻訳に異なった手順が必要かもしれません。外部 wiki のリストは ヘルプ:i18n にあります。
特別なメッセージの翻訳
Arch Wiki にはいくつか特別なメッセージが使われています。次のリンクからその翻訳を提供してください:
- Also in (カテゴリツリー内のメッセージ): en:Talk:Table of contents#"also in" translations
- Talkpagetext : en:MediaWiki talk:Talkpagetext#Talkpagetext translation
ブレーンストーミング
リアルタイムに他のユーザーと一緒に貢献するために、公式の #archlinux-wiki IRC チャンネルがあります。どこから始めたらいいかわからなかったり、他の人が書いたものを編集するのに気が引けるのなら、Arch Linux フォーラム の フォーラム & Wiki の話題 セクションにアイデアや提案を投稿して貢献することもできます。
バックエンドメンテナンス
Arch Linux Bugtracker を使ってバグを報告したり MediaWiki のコードベースにフィックスや改善を加える。ArchWiki のバックエンドの報告されたバグのリスト も参照してください。
異議申し立て
wiki が管理される方法についての一般的な否定的な意見や不満があれば、ArchWiki・トーク:メンテナンスチーム にメッセージを残してください。もちろん、丁寧な口調で不満を言うことが可能であると述べる必要はありませんよ。 :) 特定の編集やページについての不満には、もっと適切な議論ページを使ってください。