始める前に

TechNet Wiki は空港のようなものだと思います。そこには多くのさまざまな人がいて、目的を持って空港にやってきて、多くの異なる行先へと向かいます。ただし、私たち全てがお互いとルールへ敬意を払わなくてはならない確かな作法や配慮があり、それを守らなければ全てが壊れてしまいます。そのとき、私たちの目的地を把握できる人は誰もいません。

これらの作成ガイドラインはそれらの「ルール」のことです。もしあなたが私たちの空港にいるなら、私たちはあなたに以下のようなことを期待します。

  1. あなたの行動によって他者の行動を妨げることのないように注意してください。例えば、この記事を読み進めて、タグの変更についてのルールを確認してください。誰かが始めた何かについて作業する場合の、ソースについての材料へのリンク方法についても以下のアドバイスを読むようにしてください。親切であってください。
  2. 航空警備を援助するためにできることをしてください。でなければ、私たち全てが遅れることになるでしょう。例えば、ID を出しておいたり、事前に靴を脱いでおいたり、バッグのパッキングについて知っておきルールに従う、そのようなことです。Wiki においては、これは "wiki" や "core docs" とタグの付けられた記事を読むということを意味します。
  3. ルールを忘れたり、まだ分かっていない人を助けてください。
  4. サイトで、他の人がリクエストしたコンテンツのための提案ボックスをチェックしてください。
  5. あなたが貢献できるスタブのページを見つけてください。
  6. Wiki Ninja の Twitter アカウントをフォローしてください。
  7. ( もし利用しているなら ) Twitter の #TNWIKI ハッシュタグに倣ってください。

作成するためには、サインインする必要があります。サインインするために参加してください。参加する方法を学ぶには、TechNet Wiki: 参加するには の記事を確認してください。

始めるために最も早い方法は、誰かがあなたの助けを必要としていることを表すようなタグをクリックすることです。例えば、needs work stub などがあります。始めるために最も簡単な方法は、survival guide の 1 つへとリンクを追加することです。


コンテンツ

  1. 技術コンテンツ (IT プロや開発者 ) - あなたがコンシューマーであったりコンシューマー向けの記事を書きたいと思っているのであれば、この種類の記事は探しているものではないでしょう。ただし、「 IT プロのコンテンツ」についての境界線は曖昧なものです。例えば、IT プロと開発者の両方が興味を持つが、どちらかによって独占的に所有されないような、スクリプトについての記事も歓迎されます。
  2. オリジナルのコンテンツ - Wikipedia の経験では、ほとんどの記事はスタブやアウトラインの状態から始まります。これらを自由に始め、コンテンツを共同作成していく助けとなるようなテクニカル ライターやレビュアー、編集者、イラストレーターを募集してください。これらには needs work stub タグを付けるようにしてください。
  3. 広告 - 何らかの広告を出すために存在するコンテンツは許可されませんし、削除されます。

ノート: あなたが作成したものではない記事を TechNet/MSDN もしくは 他の Web サイト、ブログ、その他のソースからコピー / ペーストするだけで作成することはしないでください。もしこれを行い、何の編集や書き直し、改良も無しに保存する場合、あなたは盗作を行っていることになります。もしあなたがブログや他の Web サイトで書いた内容について作成するのであれば、記事のトップにオリジナルへのリンクを追加しておくことが重要です。例えば、「この文書は < オリジナルへのリンク > にてオリジナルが公開されたもので、このトピックのオリジナル バージョンを更新する前に、コミュニティが不正確な記述を修正したりその他の拡張を提供することを許可するために再構成されています」コピー / ペーストしたものをあなたの名前で保存することは盗作です。私たちはここではそれを賛同しません。著作権を侵害しているものは削除されるでしょう。

  1. 信&#38972;される人になる
    • 盗用をしないでください。
    • 演技をしないでください。自分の行動に責任を持ってください。
    • しつこい広告やマーケティングのコンテンツを投稿しないでください。削除されます。
    • しつこくない程度の広告やマーケティングのコンテンツや技術的価値の無いコンテンツも同様に削除されます。例えば、Hyper-V で何かをする方法についての記事があり、そこに「これは VMware なら簡単にできます」と追加すると削除されます。ただし、記事が手順を指していて、それが例えば「SCVMM を利用して Hyper-V 仮想マシンを管理する方法」のようなものならば、SCVMM を利用して VMware 仮想マシンを管理する方法を追加することは適切です。VMware を使って VMware の仮想マシンを管理する方法についての情報は TechNet Wiki にふさわしくありません。別の例として、特定のスマートフォンについてのレビューは歓迎しません。Exchange のようなソフトウェアを利用した展開や管理、最適化、利用の方法についての情報は歓迎します。Xbox 360 のゲームやハードウェアについてのレビューは歓迎しません。プログラム、対処、修正や、言い換えれば Xbox 技術の最適化方法についての情報は歓迎します。
    • 技術的に正しくない情報につては、報告や修正をしてください。例えば、サンプル スクリプト内のエラーなどです。
  2. プレリリースの内容にラベルを付ける - それが重要な場合には製品のバージョンを明確にしてください。NDA ( 秘密保持契約 ) によって守られている製品についての内容を投稿してはいけませんし、公開することはできません。プレリリースの内容についての情報を投稿しないでください。Microsoft 製品のプレリリースのプロセスに参加するための場所としては、Microsoft Connect があります。
  3. HTML をきれいにする - Microsoft Word や PowerPoint からコピー / ペーストすると書式に問題が起こります。より具体的な手順については、以下の書式設定のセクションを参照してください。私たちは Windows Live Writer でオーサリングし、それからそこへペーストすることを推奨します。フリーで利用できる Windows Live Writer は http://windows.microsoft.com/ja-JP/windows-live/essentials-other-programs からダウンロードできます。
  4. 画像 - Wiki の記事で、画像の最大幅は 600 ピ��セルです。600 ピクセルよりも大きな幅の画像��共有する際にはリサイズするようにしてください。
  5. スタイル - Wiki スタイルのガイドラインに従ってください。テンプレートを利用することは非常に有用です。
    1. 始めるうえで、このブログの投稿を読むことも役立ちます。 いくつかの素晴らしいアドバイスがあります。
      • 成功するコンテンツは - 何であれ、誰であれ、どんなプラットフォームであれ、どんな終わりであれ - 何らかで成功したベンチャーがするような、他者が何について気にかけているかを知ること、そして彼らにそれ ( あなたが望むものではなく、彼らが 1 番に望むもの ) を提供することによって知識を披露することと同じことを要求します。
    2. もしあなたが、あなたがすることと同じものについて話す他の人へ注意を払っていなければ、あなたのコンテンツは成功しないでしょう。
    3. もしあなたが、全てを完璧に具現化し全ての人が気に入ると本当に思った、非常に賢いキャッチフレーズや幻想的なコピー、そして有益な投稿を考え出したなら、それはあなたがそれをするためにあまりに多くの時間を費やしたからです。ただ、誰かほかの人と一緒に検&#35388;をしないと、あなたのコンテンツは成功しないでしょう。
    4. 国際的な聴衆に向かって書くには に倣うことで、英語を母国語としない読み手がいることを認識してください。そうすることで、潜在的な範囲を劇的に拡大することができます。
  6. 助けを依&#38972;する 質問があったり、いくつかの Wiki コンテンツで Microsoft の誰かと共同作業をしたいなら、Wiki のフォーラムへリクエストを投稿するだけです。

Wiki へ貢献するための方法

  • オンライン編集とは、作成や編集をするために組み込まれた Wiki コントロールを利用することを意味します。
    • エディターを利用するための 10 分間の動画は、こちらを見てください。
    • エディターの利用方法の詳細については、Wiki: エディターの利用 を確認してください。
  • オフライン編集。多くの人は、たくさんの書式を必要としない短期間のタスクのために不足の無いこれらのコントロールを見つけます。長期間のタスクと、細かい書式設定が可能なもっと多くのコントロールのためにオフライン編集を利用してください。うまく動作するオフライン編集ツールには以下のものがあります。
    適切な HTML 文法を使うために W3Schools.com を参照して生の HTML を編集する場合、それがどのように表示されるのかプレビューするために、生の HTML を描画するための "Try it yourself" 機能を使ってください。

URL とリンク

新規ページや存在するページへのリンク

Wiki エディターのページで [ [Publishing Guidelines] ] と入力 ( 実際にはブラケットの間にスペースは入れません) すると、このページにリンクが生成されます。もし指定された名前のページが存在しなければ、作成されます。既定では、新規のリンクは、リンクが作成されたページのサブページとして作成されます。もし指定された名前のページが Wiki 上に既に存在しているなら、ユーザーがサブページのリンクを指定しなくても、そのページへのリンクとなります。

Wiki から外部へのリンク

Wiki の記事への URL は、フルの URL と部分 ( 相対 ) URL のどちらでも参照できます。Wiki からのリンクは基本的な HTML のリンクを記述したり、新しいリンクを生成するためにエディターのリンクボタンを使うのと同様に単純です。外部へのリンクは Wiki の記事の中で次のような画像とあわせて示されます。


ファイル

ファイルの設置

ファイルを設置することはできません。どこかへ投稿した動画や、Script Center Gallery にあるスクリプト、そして Skydrive や Flicker のような他のサービスへアップロードしたファイルへリンクすることはできます。

画像

  • 画像が 600px よりも大きい場合は、600px へとリサイズすべきです。
  • そうしないのであれば、その時はソースへのリンクを追加するようにしてください。( より良くなるようにしてください )

タグ

タグはキーワードと&#20284;たもので検索インデックスを含みますが、コンテンツの読者には表示されません。全ての新しいコンテンツを作成するためには、少なくとも 1 つ以上のタグが必要です。

もしそれらが正しくないと思っても、タグを消さないようにしてください。消すのではなく、あなたが思うタグを追加するようにしてください。例えば、"HyperV" とのタグが付けられた有用なコンテンツを見つけた場合、このタグを消したり、"Hyper-V" タグへと置き換えないようにしてください。この場合、"HyperV" タグを残したまま "Hyper-V"タグを追加することだけをしてください。それは、誰かが "HyperV" タグを付けたのには重要な意味があったかもしれず、記事を見つけるためにそのタグを使っているかもしれないからです。

書かれた記事の言語を示すタグを付けるようにしてください。日本語の場合なら ja-JP というタグを付けるようにしてください。これはコミュニティのメンバーが、日本語で記述された記事を分類したり選別することを簡単にするための手助けになります。


書式

<h1>、<h2> などのような、標準的な書式のコマンドを利用してください。全ての書式は ( 印刷と画面表示ともに ) スタイルシートによって実行されます。

記事のタイトル

記事のタイトル分割して&#26684;納され、<title> タグや、パンくずリスト、サイドバー ナビゲーション、そして最も重要なものとして URL にも利用されます。

上記の記事タイトル例は、How To Contribute になります。その URL は、http://social.technet.microsoft.com/wiki/contents/articles/how-to-contribute.aspx です。もし記事のタイトルを "Wiki: How to Contribute" へ変更すると、URL も同様に変更され、その記事へのリンクも壊れることになります。英語の場合、それぞれの単語を大文字で開始するほうが好まれます。( ただし、ほとんどの前置詞と冠詞は除きます )

目次

Wiki に目次は自動で作成されません。長い記事に小さな目次を作成するかどうかは自由です。記事に動的な目次を追加するためには、toc という文字をブラケット( [ ] ) の間に記述するだけです。( 例として、この記事のトップを確認してください。)

テーブルの挿入

Wiki: Create Quick and Basic Tables Using the Wiki HTML Editor (英語)

トップへ戻る リンク

記事のセクションが 1 個か 2 個よりも長くなる場合は、各セクションの最後に トップへ戻る のような役立つリンクを挿入することができます。どのようにしてこの機能を Wiki の記事に追加するかを Kurt L Hudson WikiNinjas Official Blog にて説明しています

もし間違って重複した内容の記事を投稿してしまったり、その他正しい理由で記事を削除したい場合、自身で記事を削除することはできません。記事を物理的に削除できるのは、管理者かモデレーターだけです。その代わり、Wiki User Guide: Handling Abuse で説明されているように記事のタイトルと本文を変更して、タグを "Candidate for Deletion, spam" にしなければなりません。


関連項目

他の言語