ArchWiki:貢献

提供: ArchWiki
2020年3月29日 (日) 11:54時点におけるNy-a (トーク | 投稿記録)による版 (→‎Always properly use the edit summary: 追加訳出(→‎常に効果的に要約欄を使う: にセクション見出しを変更)(ID: 15827 の版での同期部分の翻訳))
ナビゲーションに移動 検索に移動

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

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

3つの基本的なルール

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

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

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

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

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

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

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

Do not make complex edits at once

If you want to make an extensive change to a page, be it a normal article or a discussion page, always split your work in several simple edits, for example according to the various logical steps needed to complete it. If in doubt, preview the resulting diff with the "Show changes" button and wonder if another user would be able to understand it, also considering the edit summary as explained above. Some common operations that generate confusing diffs are:

  • Moving a section in an article and at the same time editing its content. Solution: move the section unchanged, save, and change its content in a following edit.
  • Reordering several sections of an article at the same time. Solution: move only one section per edit.
ノート: This practice will naturally increase the number of entries in 特別:最近の更新: do not be worried at all by this, users can easily filter that list by enabling the Group changes by page in recent changes and watchlist setting under Preferences > Recent changes > Advanced options.

Announce article rewrites in a talk page

If you want to radically restructure or rewrite an article or a group of articles, announce and explain your intention in an appropriate talk page first, giving any other interested users some reasonable time to reply and share their view.

Keep in mind that announcing intended changes does not exempt edits from #Always properly use the edit summary and #Do not make complex edits at once.

The most important task

In the remainder of this article you will be presented with the various ways you can contribute to the wiki. Among them, however, there is one that you should consider far more important than the others: add your favorite articles to your watchlist and protect them against counter-productive edits.

Every day, ArchWiki receives several dozens of edits from many different users: while most of these changes are actual improvements, it only takes one single edit, often made in good faith, to inaccurately alter the meaning of a whole paragraph or a section, or sometimes even unreasonably delete it altogether; if gone unnoticed, this will ruin the valuable work that you and all the other previous editors had done. Unfortunately, this occurs more frequently than you would expect: the official wiki staff does try their best to filter and fix counter-productive edits, but you should never rely completely on them, both because, just like you, they have limited time to spend on the wiki, and also because they are not omniscient, and it is very likely that your knowledge on the topics treated in your favorite articles is greater than theirs. In general, a wiki simply does not work if users only focus on writing new content but then do not care about what happens to their contributions.

Fortunately, there is a very easy way for you to follow the articles to which you contributed or those that you like the most or are most knowledgeable in: at the top of every article there is a "watch" link, and by following it, that article will be added to your watchlist. You will then be able to follow the changes in 特別:ウォッチリスト, or by choosing to be notified by email when the watched articles receive updates in the "Email options" field of 特別:個人設定#mw-prefsection-personal; the pages you are following will also be highlighted in bold in 特別:最近の更新. Finally, preferences for the watchlist are found in 特別:個人設定#mw-prefsection-watchlist: among the options you can even choose to automatically start watching the pages that you create or edit.

If you notice that an article in your watchlist has received an inaccurate edit, or you just do not understand it, you are strongly encouraged to either fix it, if possible, or to start a discussion in the article's talk page, or in the responsible author's talk page.

Resources

以下は貢献するために必要な情報を含むページの一覧です。

  • ヘルプ:記事命名ガイドラインでは効果的な記事の命名規則と wiki の可読性とナビゲーションを向上させるために考慮すべきことについて論じています。新しいページを作成する前に読んで下さい。
  • ヘルプ:編集では広く使われている MediaWiki のマークアップと ArchWiki 特有のガイドラインを説明してます。全ての編集者が読むべきページです。
  • ヘルプ:議論 guides you on how to discuss with people in talk pages.
  • ヘルプ:スタイルには ArchWiki の記事の文体の標準化のためのガイドラインがあります。
  • ヘルプ:カテゴリではページカテゴリの設定方法や、存在しないカテゴリの作成方法、他のカテゴリにページを移動する方法を説明しています。
  • ArchWiki 翻訳チームには手順を追って新しい翻訳ページを作成するイントロダクションがあります。ページをあなたの言語に翻訳するときに参照してください。
  • ヘルプ:i18n では ArchWiki の国際化と地域化についての包括的なガイドラインが書かれています。
  • en:Help:Procedures is a collection of useful check lists for complex operations.

全てのヘルプ記事はカテゴリ:ヘルプで見てください。

作成

ArchWiki の方針(フィロソフィー)を理解して他の人が読みたいと思うものは何か考えて下さい (ArchWiki:リクエスト にアイデアがあります)。上で述べたようにこの wiki ではとても広い範囲をカバーしています。

大きなプロジェクトの調整を手伝いたいならば管理者に申告してください。

ヘルプ:編集#ページの作成 covers the steps to create a new article in the main namespace.

The wiki's subpage feature (article/subpage) is available for your userpage as well. Using it you could create the draft on a blank subpage. Please note that userpage content must not be categorized, but all other features can be used. Once you have finished drafting, you can simply move the subpage to its new name. Please add relevant article status templates (only) after you moved it. The better you describe a status template's reason, the easier it is for users #整備 the wiki to collaborate with you.

整備

内容の編集、校正、保守はどの wiki でも果てしのない (never-ending) 作業になります。もしあなたが手伝っていただけるのならば、アカウントを登録してあなたの魔法を使い始めて下さい。

Non-Arch users

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:

  • 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;
  • do not replace mentions of Arch-specific conventions, terminology or utilities with alternatives that may apply to a broader range of operating systems.

保全

編成

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

翻訳

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

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

Special messages translation

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 here
  • Talkpagetext : Add translation here

ブレーンストーミング

To coordinate contributions with other users in real time, there is an official dedicated #archlinux-wiki IRC channel. どこから始めたらいいかわからなかったり、他の人が書いたものを編集するのに気が引けるのなら、Arch Linux フォーラムフォーラム & Wiki の話題 セクションにアイデアや提案を投稿して貢献することもできます。

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

Arch Linux Bugtracker を使ってバグを報告したり MediaWiki のコードベースにフィックスや改善を加える。See the list of reported bugs for the ArchWiki back-end.

Complaining

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.