「ヘルプ:記事命名ガイドライン」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(同期)
72行目: 72行目:
 
=== 装飾的な語句は避ける ===
 
=== 装飾的な語句は避ける ===
   
  +
装飾的な語句(例えば前の例では "alternative")だけが装飾的ではありません。それらの語句は普通の語句に比べてあまり使われず、長い傾向にあります。日常的に使う語句はほとんどの場合短いことが知られています。一般的な代わりの語句を探してみてください。
Fancy words (like "alternative" in our example) are not only fancy; they are used less often than ordinary words, and thus tend to be longer. It is well known that words that are used regularly are in most cases shorter, so try to find an ordinary alternative for your words.
 
   
  +
"alternative" と言う代わりに、"other" と言うことができるかもしれません。
Instead of saying "alternative", you may say "other".
 
   
 
以下の二つを比べてみて下さい:
 
以下の二つを比べてみて下さい:

2020年3月31日 (火) 00:40時点における版

関連記事

Wiki の作成・編集において記事の命名は最も重要な仕事の一つです。この記事は記事の名前を選ぶときの完全なガイドラインであり、ArchWiki を作成・編集するときに考えるべき問題を提示しています。

記事の名前について

記事の名前には2つの用途があります。ArchWiki サイトの wiki コンテンツの識別子であると同時に、読者が中身を見分ける手段でもあります。したがって、記事の名前は一意であり、分かりやすいものにしなくてはなりません。

ときどき、記事の名前にはコンテンツのタイプが反映されることがあり、記事が書かれている言語などの情報が加えられることもあります。

記述的な名前

名前はできるかぎり具体的に、記事が扱っている範囲が何なのか分かるようにしてください。

新聞やニュースサイトに掲載されるようなソフトウェア・ハードウェアのレビューとドキュメントプロジェクトは違います。ドキュメントが読まれるのは普通、何か問題が起こったときや特定の要件を満たす必要が出てきたときです。したがって、何が必要なのかすぐに確認できて、さっと解決できることが一番重要です。可読性を高めつつ情報にすぐたどり着けるように、記事の名前 (タイトル) は記述的で、記事の中身をはっきり示すものである必要があります。

サンプル

"Boost pacman" (「pacman の高速化」) のようなタイトルは読者を勘違いさせてしまう可能性があります。ユーザーは pacman の「何か」を高速化させる記事だと考えるでしょうが、記事の内容が思っていたものと同じだとは必ずしも限りません。したがって、記事の名前はできるだけ分かりやすくそれでいて長くなりすぎないようにしてください。例として出した記事の名前は "How to improve pacman download speed using wget, snarf, and lftp" と具体的にすることができます。

記事の追記の余地を残す

将来的に記事のコンテンツを追加できるように普遍的な名前を使ってください。

今後の編集や改善の余地を残すために、ときとして記事の名前はあまり限定的にしないほうが良いことがあります。もちろん、記事の名前を短くするためだけに具体的な情報を削るのはよろしくありません。一方で、主だったことは全て記述されていて、将来的に記事の扱う範囲が広がることがないのであれば、記事の名前はできるだけ具体的にしたほうが良いでしょう。

サンプル

前の例に戻ってみましょう。新しい記事のタイトルは "Improve pacman download speed using wget, snarf, and lftp" です。しかしながら、新しいダウンロードマネージャが登場して wget, snarf, lftp などを置き換える日がいつか来るかもしれません。したがって記事の名前をもう少し普遍的なものに変えます: "How to improve pacman download speed using alternative download managers"。

記事の名前は短くする

名前はできるかぎり短くしてください。

記事のリストをすばやく一瞥できるように記事の名前は短くしてください。ほとんどの人は wiki を読むときブラウズテクニックを使うので、長々とした名前を記事に付けると無駄に時間を浪費させることになります。また、短い名前はプロフェッショナルっぽく聞こえます。

以下では "How to improve pacman download speed using alternative download managers" という名前を例として使っています。

名前を短くするテクニックを全て挙げることはできません。使用できるテクニックは他にもたくさんありますが、とりあえずタイトル編集の「概念」を理解するには役立つでしょう。

ノート: 記事のタイトルを直訳することはときとして困難です。言語にあわせて相応しいタイトルを考えてください。英語以外のテクニックが必要となることもあります。

質問形式の名前は使わない

"How to improve" とするかわりに、シンプルに "Improve" としてください。

以下の二つを比べてみて下さい:

  • "How to improve pacman download speed using alternative download managers"
  • "Improve pacman download speed using alternative download managers"

長い語句は言い換える

"Improve pacman download speed" という文章は冗長です。代わりに、"Speed up pacman download" とします。

以下の二つを比べてみて下さい:

  • "Improve pacman download speed using alternative download managers"
  • "Speed up pacman download using alternative download managers"

装飾的な語句は避ける

装飾的な語句(例えば前の例では "alternative")だけが装飾的ではありません。それらの語句は普通の語句に比べてあまり使われず、長い傾向にあります。日常的に使う語句はほとんどの場合短いことが知られています。一般的な代わりの語句を探してみてください。

"alternative" と言う代わりに、"other" と言うことができるかもしれません。

以下の二つを比べてみて下さい:

  • "Speed up pacman download using alternative download managers"
  • "Speed up pacman download using other download managers"

正式な技術的表現からの逸脱

技術に精通しているユーザーからは賛成されないかもしれませんが、大抵の人は全く気にしません。記事の名前が短くなるなら、技術用語を使わないようにしてください。

"download managers" とするかわりに、"downloaders" とします。

以下の二つを比べてみて下さい:

  • "Speed up pacman download using other download managers"
  • "Speed up pacman download using other downloaders"

結果を見直す

焦ってはいけません。短くしたタイトルを見比べてみて意味が通っているか確認するようにしてください。

  • "How to improve pacman download speed using alternative download managers"
  • "Speed up pacman download using other downloaders"

Okay, we see the end result is a much shorter article name, but what about its meaning? Well, it certainly seems like we did a good job. But now we have a different problem. pacman is not a downloader; both "alternative download managers" and "other downloaders" imply that pacman is a downloader, which is not what we want. We need to change the meaning by saying "external downloaders".

以下を比べてみて下さい:

  • "How to improve pacman download speed using alternative download managers"
  • "Speed up pacman download using other downloaders"
  • "Speed up pacman download using external downloaders"