「ArchWiki:貢献」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(→‎作成: 追加訳出(ID: 15827 の版での同期部分の翻訳))
(同じ利用者による、間の9版が非表示)
64行目: 64行目:
 
* [[ArchWiki 翻訳チーム]]には手順を追って新しい翻訳ページを作成するイントロダクションがあります。ページをあなたの言語に翻訳するときに参照してください。
 
* [[ArchWiki 翻訳チーム]]には手順を追って新しい翻訳ページを作成するイントロダクションがあります。ページをあなたの言語に翻訳するときに参照してください。
 
* [[ヘルプ:i18n]] では ArchWiki の国際化と地域化についての包括的なガイドラインが書かれています。
 
* [[ヘルプ:i18n]] では ArchWiki の国際化と地域化についての包括的なガイドラインが書かれています。
* [[:en:Help:Procedures]] は複雑な操作のための便利なチェックリストです。
+
* [[ヘルプ:操作手順]] は複雑な操作のための便利なチェックリストです。
 
全てのヘルプ記事は[[:カテゴリ:ヘルプ]]で見てください。
 
全てのヘルプ記事は[[:カテゴリ:ヘルプ]]で見てください。
   
80行目: 80行目:
   
 
* [[ArchWiki:リクエスト|リクエスト]]を満たすのを手伝う。
 
* [[ArchWiki:リクエスト|リクエスト]]を満たすのを手伝う。
* [[:カテゴリ:Template:Stub が使われているページ|スタブ]]ページに内容を追加したり[[:カテゴリ:Template:Expansion が使われているページ|未完成]]または[[:カテゴリ:Template:Style が使われているページ|中身が乏しい]]記事を拡充する。
+
* [[:カテゴリ:Template:Expansion が使われているページ|未完成]]または[[:カテゴリ:Template:Style が使われているページ|中身が乏しい]]記事を拡充する。
 
* [[:カテゴリ:Template:Accuracy が使われているページ|不正確]]だったり[[:カテゴリ:Template:Out of date が使われているページ|古くなった]]内容を修正したり、綴り・文法・言葉遣い・[[ヘルプ:スタイル|文体]]を校正する。
 
* [[:カテゴリ:Template:Accuracy が使われているページ|不正確]]だったり[[:カテゴリ:Template:Out of date が使われているページ|古くなった]]内容を修正したり、綴り・文法・言葉遣い・[[ヘルプ:スタイル|文体]]を校正する。
   
=== Non-Arch users ===
+
=== Arch を使っていないユーザー ===
   
  +
誰でも[[ヘルプ:編集#アカウントの作成|アカウントを作成]]できます。Arch を使っていないユーザーは、Arch Linux にも適用できることが確かである限り、他の Linux ディストリビューションや OS に適用できる内容を貢献しても構いません。具体的には、記事は Arch のユーザーに向けて書かれなければいけません。つまり:
Anyone can [[ヘルプ:編集#アカウントの作成|register an account]]: non-Arch users are welcome to contribute content that applies to other Linux distibutions or operating systems, as long as they are confident that it also applies to Arch Linux. In particular, articles must be written specifically for Arch users, therefore:
 
   
  +
* 他の Linux ディストリビューションや OS に特有のコメントを追加しないでください。例えば、Fedora ユーザーが [[systemd]] ページに貢献するのは構いませんが、新しく追加された内容が Fedora でも動くということに言及するのは無関係として削除されます。
* do not add comments peculiar to other Linux distributions or operating systems; for example, a Fedora user contributing to the [[systemd]] page would be fine, but mentioning that the newly added content works on Fedora would be edited out as irrelevant;
 
  +
* Arch 特有の慣習・用語・ユーティリティをより広い範囲の OS に適用できる代替に置き換えないでください。
* do not replace mentions of Arch-specific conventions, terminology or utilities with alternatives that may apply to a broader range of operating systems.
 
   
 
==保全==
 
==保全==
* [[特別:最近の更新|最近の更新]]のパトロール、[[:en:Help:Procedures#Common problems and solutions|問題のある編集]]の修正、報告
+
* [[特別:最近の更新|最近の更新]]のパトロール、[[ヘルプ:操作手順#一般的な問題と解決法|問題のある編集]]の修正、報告
 
* {{Ic|<nowiki>{{Out of date}}</nowiki>}}, {{Ic|<nowiki>{{Accuracy}}</nowiki>}}, {{Ic|<nowiki>{{Remove}}</nowiki>}}, {{Ic|<nowiki>{{Archive}}</nowiki>}} など適切な[[ヘルプ:テンプレート#記事の状態テンプレート|記事の状態テンプレート]]を使って記事のフラグを立てる。
 
* {{Ic|<nowiki>{{Out of date}}</nowiki>}}, {{Ic|<nowiki>{{Accuracy}}</nowiki>}}, {{Ic|<nowiki>{{Remove}}</nowiki>}}, {{Ic|<nowiki>{{Archive}}</nowiki>}} など適切な[[ヘルプ:テンプレート#記事の状態テンプレート|記事の状態テンプレート]]を使って記事のフラグを立てる。
* 記事をあなたのウォッチリストに追加して記事を逆効果の編集から防ぐ。([[#The most important task]])
+
* 記事をあなたのウォッチリストに追加して記事を逆効果の編集から防ぐ。([[#最も重要なタスク]])
 
* 様々なページの議論に参加する: ほとんどのユーザーが興味を持つのは議論の最新の投稿でありそれは[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] にリストされています; さらに、[[ArchWiki:リクエスト]] が議論ページとして使われています。
 
* 様々なページの議論に参加する: ほとんどのユーザーが興味を持つのは議論の最新の投稿でありそれは[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] にリストされています; さらに、[[ArchWiki:リクエスト]] が議論ページとして使われています。
   
102行目: 102行目:
 
* wiki の[[目次|ナビゲーション]]を改善する。
 
* wiki の[[目次|ナビゲーション]]を改善する。
 
* [[特別:カテゴリ未導入のページ|カテゴリ分類されていないページ]]や[[特別:カテゴリ未導入のカテゴリ|カテゴリ分類されていないカテゴリ]]をカテゴリに入れたり[[特別:存在しないカテゴリへのリンク|カテゴリページが存在しないカテゴリ]]のカテゴリページを作る。[[ヘルプ:スタイル#カテゴリ]]や[[ヘルプ:スタイル#カテゴリページ]]を見て下さい。
 
* [[特別:カテゴリ未導入のページ|カテゴリ分類されていないページ]]や[[特別:カテゴリ未導入のカテゴリ|カテゴリ分類されていないカテゴリ]]をカテゴリに入れたり[[特別:存在しないカテゴリへのリンク|カテゴリページが存在しないカテゴリ]]のカテゴリページを作る。[[ヘルプ:スタイル#カテゴリ]]や[[ヘルプ:スタイル#カテゴリページ]]を見て下さい。
* [[特別:迷子のリダイレクト|迷子]]や[[特別:二重リダイレクト|二重]]のリダイレクトを修正する。 Discuss or apply [[:カテゴリ:Template:Redirect が使われているページ|proposed redirects]].
+
* [[特別:迷子のリダイレクト|迷子]]や[[特別:二重リダイレクト|二重]]のリダイレクトを修正する。 [[:カテゴリ:Template:Redirect が使われているページ|提案されたリダイレクト]]を適用するか議論してください。
 
* 整理に役立つ他のツールは [[特別:特別ページ一覧]] を見て下さい。
 
* 整理に役立つ他のツールは [[特別:特別ページ一覧]] を見て下さい。
   
122行目: 122行目:
 
外部 wiki を使っている言語もあります、外部 wiki では翻訳に異なった手順が必要かもしれません。外部 wiki のリストは [[ヘルプ:i18n]] にあります。
 
外部 wiki を使っている言語もあります、外部 wiki では翻訳に異なった手順が必要かもしれません。外部 wiki のリストは [[ヘルプ:i18n]] にあります。
   
  +
=== 特別なメッセージの翻訳 ===
=== Special messages translation ===
 
   
  +
Arch Wiki にはいくつか特別なメッセージが使われています。次のリンクからその翻訳を提供してください:
There are some special messages used in Arch Wiki, please provide their translation for your language in the following link:
 
   
* Also in (Message in Categories tree): Add translation [[:en:Talk:Table of contents#"also in" translations|here]]
+
* Also in (カテゴリツリー内のメッセージ): [[:en:Talk:Table of contents#"also in" translations]]
* Talkpagetext : Add translation [[:en:MediaWiki talk:Talkpagetext#Talkpagetext translation|here]]
+
* Talkpagetext : [[:en:MediaWiki talk:Talkpagetext#Talkpagetext translation]]
   
 
==ブレーンストーミング==
 
==ブレーンストーミング==
To coordinate contributions with other users in real time, there is an official dedicated [[:en:ArchWiki:IRC|#archlinux-wiki]] IRC channel. どこから始めたらいいかわからなかったり、他の人が書いたものを編集するのに気が引けるのなら、[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 のコードベースにフィックスや改善を加える。See the [https://bugs.archlinux.org/index.php?string={wiki}&project=0 list of reported bugs] for the ArchWiki back-end.
+
[https://bugs.archlinux.org/ Arch Linux Bugtracker] を使ってバグを報告したり MediaWiki のコードベースにフィックスや改善を加える。ArchWiki のバックエンドの[https://bugs.archlinux.org/index.php?string={wiki}&project=0 報告されたバグのリスト] も参照してください。
   
== Complaining ==
+
== 異議申し立て ==
   
  +
wiki が管理される方法についての''一般的な''否定的な意見や不満があれば、[[ArchWiki・トーク:メンテナンスチーム]] にメッセージを残してください。もちろん、丁寧な口調で不満を言うことが可能であると述べる必要はありませんよ。 :) ''特定の''編集やページについての不満には、もっと適切な議論ページを使ってください。
If you have any ''generic'' negative remarks or complaints about how the wiki is moderated or administered, please leave a message in [[ArchWiki・トーク:メンテナンスチーム]]. Of course it should not be necessary to state that it is indeed possible to complain about something using a civil and respectful tone :) For complaints regarding ''specific'' edits or articles, please use a more appropriate talk page.
 

2020年5月22日 (金) 13:40時点における版

ArchWiki はクリアで、総合的、そしてプロフェッショナルなドキュメンテーションのモデルになるよう努力しています。そのゴールを達成するために私達は合理的で機能的な方法で仕事を組織する必要があります: この記事ではあなたが貢献できる一番重要な仕事を模式的に説明します。

これはコミュニティの取り組みですが、あなたが本気で仕事を引き受けてくれるなら、wiki メンテナとして正当な地位に就くことになるでしょう。

3つの基本的なルール

全ての貢献者は、初心者を含めて、他の wiki ユーザーへの敬意の表れとして従うべきシンプルなルールがあります。#常に効果的に要約欄を使う#一度で複雑な編集をしない#議論ページでページの書き換えを知らせるの3つです。

全ての wiki の貢献者は、他のユーザーによって編集が早かれ遅かれ確認されることを想定・期待しなければなりません。そして、以下のルールに従って他のユーザーができるだけ早く簡単に確認できるようにして、他のユーザーのその権利を尊重しなければなりません。共同のソフトウェアプロジェクトに慣れている人は、wiki の編集の要約と git のコミットメッセージ・wiki の編集の差分と git の差分の類似点を簡単に理解できるでしょう。

警告: これらの基本的なルールを守らない編集や、合理的な努力として理解されない編集は、何の警告もなく完全に差し戻されるかもしれません。特に、人気のあるページに影響する場合はその可能性が高くなります。

常に効果的に要約欄を使う

編集の要約は小さいテキストボックスで、ページの編集エリアの下・「変更を保存」ボタンのすぐ上にあります。常に何をしたか、なぜしたかを簡潔に書くことはとても重要です。要約欄では wiki の内部リンクが使えるため、関連するページや議論へのリンクに使ってください。同じように、関連する編集の差分や、フォーラムのスレッドやメーリングリストのような外部のリソースへの URL を貼り付けてください。

例えば文法や綴りの修正・文のシンプルな言葉遣いの変更など、細部の編集の場合だけは、なぜかの部分を省くことができます。同じように、新しい議論を始める場合や、議論に返信する場合は、要約欄に同じメッセージを書き直す必要はありません。

ヒント:
  • 特別:最近の更新の編集の要約を見て、要約に何を書くべきかの発想を得ることができます。しかし、残念ながら全てのユーザーがこれらのガイドラインを知っているわけではないことに注意してください。
  • 特別:差分/9791/next のようなリンクを使って差分へのクリックできる参照を作ることができます。構文の詳細は mw:Help:Diff/ja を参照してください。

一度で複雑な編集をしない

ページに広範囲に渡る変更を加えたいときは、通常のページか議論ページかに関わらず、常にいくつかのシンプルな編集に分割してください。例えば、編集におけるいくつかの論理的な段階に従って分割することができます。疑わしいときは、結果の差分を確認するために「差分を表示」ボタンを押して、他のユーザーが理解できそうか確認してください。上で説明した要約もよく考えてください。複雑な差分を発生させる一般的な操作には以下のようなものがあります:

  • ページ内でセクションを移動するのと同時にその内容を編集する。セクションを編集しないで移動して保存し、その後の編集で内容を変更することで解決できます。
  • 一度で複数のセクションを並べ替える。一度の編集で一つのセクションのみを移動することで解決できます。
ノート: このような方法は自然と特別:最近の更新の項目数を増やしますが、心配する必要はありません。ユーザーは 個人設定 > 最近の更新 > 詳細の設定 にある 最近の更新とウォッチリストで、複数の変更をページごとにまとめる を有効にすることでリストをすっきりさせることができます。

議論ページでページの書き換えを知らせる

ページや複数のページを抜本的に再構成・書き替えたいときは、始めに適切な議論ページで意図を説明して知らせることで、他の興味のあるユーザーの考えを共有するために返信する時間を作ることができます。

意図した変更を知らせることは、#常に効果的に要約欄を使う#一度で複雑な編集をしないといった編集が免除されるわけではないことに気を付けてください。

最も重要なタスク

このページではこれ以降、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 に適用できる代替に置き換えないでください。

保全

編成

カテゴリツリーを実現・改善する全ての wiki メンテナにとって記事の整理・カテゴライズ・移動は主要な仕事になります。

翻訳

翻訳を追加したり改善する; 翻訳は互いに同期するようにしてください。いくつかの言語では効率的に記事の翻訳をまとめるための共同プロジェクトを始めています (下のリストを見て下さい)。あなたの言語の翻訳チームに参加したり、記事の翻訳を始めるつもりであることを知らせることを考えてみて下さい。

外部 wiki を使っている言語もあります、外部 wiki では翻訳に異なった手順が必要かもしれません。外部 wiki のリストは ヘルプ:i18n にあります。

特別なメッセージの翻訳

Arch Wiki にはいくつか特別なメッセージが使われています。次のリンクからその翻訳を提供してください:

ブレーンストーミング

リアルタイムに他のユーザーと一緒に貢献するために、公式の #archlinux-wiki IRC チャンネルがあります。どこから始めたらいいかわからなかったり、他の人が書いたものを編集するのに気が引けるのなら、Arch Linux フォーラムフォーラム & Wiki の話題 セクションにアイデアや提案を投稿して貢献することもできます。

バックエンドメンテナンス

Arch Linux Bugtracker を使ってバグを報告したり MediaWiki のコードベースにフィックスや改善を加える。ArchWiki のバックエンドの報告されたバグのリスト も参照してください。

異議申し立て

wiki が管理される方法についての一般的な否定的な意見や不満があれば、ArchWiki・トーク:メンテナンスチーム にメッセージを残してください。もちろん、丁寧な口調で不満を言うことが可能であると述べる必要はありませんよ。 :) 特定の編集やページについての不満には、もっと適切な議論ページを使ってください。