ドキュメントの使用方法How to use the docs

この記事では、Microsoft エンドポイント マネージャー ドキュメント ライブラリの使用に関するリソースとヒントを紹介しています。This article provides resources and tips for using the Microsoft Endpoint Manager documentation library. これは Configuration Manager、Microsoft Intune、およびオートパイロットに適用され、次の領域について説明します。It applies to Configuration Manager, Microsoft Intune, and Autopilot, and covers the following areas:

  • 検索方法How to search
  • ドキュメントのバグ、改善点、質問、新しいアイデアを送信するSubmitting doc bugs, enhancements, questions, and new ideas
  • 変更通知を取得する方法How to get notified of changes
  • ドキュメントに寄稿する方法How to contribute to docs

さらにヘルプやサポートが必要な場合は、次を参照してください。For general help and support, see:

ヒント

また、Configuration Manager コンソールの [コミュニティ] ワークスペースの [ドキュメント] ノードにもアクセスしてください。Also visit the Documentation node in the Community workspace of the Configuration Manager console. このノードには、Configuration Manager のドキュメントとサポート記事に関する最新情報が含まれています。This node includes up-to-date information about Configuration Manager documentation and support articles. 詳細については、「Configuration Manager コンソールの使用」を参照してください。For more information, see Using the Configuration Manager console.

この記事の情報は、sccm-docs-powershell-ref リポジトリ内の Configuration Manager PowerShell ドキュメント にも適用されます。Information in this article also applies to the Configuration Manager PowerShell documentation in the sccm-docs-powershell-ref repository.

次の検索のヒントは、必要な情報を見つけるために役立ちます。Use the following search tips to help you find the information that you need:

  • 任意の検索エンジンを使用してコンテンツを検索するときは、あるキーワードを検索キーワードと共に指定します。When using your preferred search engine to locate content, include a keyword along with your search keywords. たとえば、Configuration Manager の場合は ConfigMgr、Intune の場合は Intune になります。For example, ConfigMgr for Configuration Manager and Intune for Intune.

    • docs.microsoft.com/mem の結果を検索します。Look for results from docs.microsoft.com/mem. docs.microsoft.com/previous-versionstechnet.microsoft.commsdn.microsoft.com の結果は、古い製品バージョンを対象としています。Results from docs.microsoft.com/previous-versions, technet.microsoft.com, or msdn.microsoft.com are for older product versions.

    • さらに検索結果を現在のコンテンツ ライブラリに絞るには、クエリに site:docs.microsoft.com を指定して、検索エンジンの範囲を指定します。To further focus the search results to the current content library, include site:docs.microsoft.com in your query to scope the search engine.

  • ユーザー インターフェイスとオンライン ドキュメントの用語と一致する検索用語を使用します。Use search terms that match terminology in the user interface and online documentation. コミュニティ コンテンツで見られる非公式な用語や略語は使用しないでください。Avoid unofficial terms or abbreviations that you might see in community content. たとえば、以下を探してみてください。For example, search for:

    • "MP" ではなく "管理ポイント""management point" rather than "MP"
    • "DT" ではなく "展開の種類""deployment type" rather than "DT"
    • "IME" ではなく "Intune 管理拡張機能""Intune management extension" rather than "IME"
  • この記事の中を検索するには、ブラウザーの 検索 機能を使用します。To search within the current article, use your browser's Find feature. ほとんどの最新 Web ブラウザーで、Ctrl+F キーを押し、検索語句を入力します。With most modern web browsers, press Ctrl+F and then enter your search terms.

  • docs.microsoft.com の各記事には、コンテンツの検索を支援するため、次のフィールドが含まれています。Each article on docs.microsoft.com includes the following fields to assist with searching the content:

    • [検索] : 右上隅にあります。Search in the upper right corner. すべての記事を検索するには、このフィールドに語句を入力します。To search all articles, enter terms in this field. このコンテンツ ライブラリ内の記事には、ConfigMgr または Intune のいずれかの検索範囲が自動的に含まれます。Articles in this content library automatically include one of the following search scopes: ConfigMgr or Intune.

      ヘッダーのドキュメント検索フィールド

    • 左側の目次の上で タイトル別にフィルター処理 します。Filter by title above the left table of contents. 現在の目次を検索するには、このフィールドに語句を入力します。To search the current table of contents, enter terms in this field. このフィールドは、現在のノードに関してのみ、記事のタイトルに表示される語句と一致します。This field only matches terms that appear in the article titles for the current node. たとえば、Configuration Manager コア インフラストラクチャ (docs.microsoft.com/mem/configmgr/core) または Intune アプリ (https://docs.microsoft.com/mem/intune/apps/) です。For example, Configuration Manager Core Infrastructure (docs.microsoft.com/mem/configmgr/core) or Intune Apps (https://docs.microsoft.com/mem/intune/apps/). 検索結果の最後の項目を使用すると、コンテンツ ライブラリ全体からその語句を検索できます。The last item in the search results gives you the option to search for the terms in the entire content library.

      目次フィルターを使用している様子のアニメーション

見つけられない項目がありますか。Having problems finding something? フィードバックを送信してください。File feedback! 検索結果に関する問題を投稿するときは、使用している検索エンジン、お試しになったキーワード、検索対象の記事を指定してください。When you file an issue about search results, provide the search engine you're using, the keywords you tried, and the target article. このフィードバックは、Microsoft がコンテンツを最適化し、より良い検索を実現するために役立ちます。This feedback helps Microsoft optimize the content for better search.

カスタム検索エンジンを追加するAdd a custom search engine

多くの最新の Web ブラウザーを使用して、カスタム検索エンジンを作成できます。With many modern web browsers, you can create a custom search engine. この機能を使用すると、docs.microsoft.com をすばやく簡単に検索できます。Use this feature to quickly and easily search docs.microsoft.com. たとえば、Microsoft Edge バージョン 77 以降では、次のプロセスを使用します。For example, with Microsoft Edge, version 77 and later, use the following process:

  1. Microsoft Edge バージョン 77 以降で、 [設定] を開きます。In Microsoft Edge, version 77 and later, open Settings.

  2. 左側のメニューで、 [Privacy, search, and services](プライバシー、検索、サービス) を選択します。In the left menu, select Privacy, search, and services.

  3. [Services](サービス) グループの一番下までスクロールし、 [Address bar and search](アドレス バーと検索) を選択します。Scroll to the bottom of the Services group and select Address bar and search.

  4. [Manage search engines](検索エンジンの管理) を選択します。Select Manage search engines.

  5. [追加] を選択し、次の情報を指定します。Select Add and specify the following information:

    • [Search engine](検索エンジン) : 検索エンジンの一覧で識別するフレンドリ名を入力します。Search engine: Enter a friendly name to identify it in the list of search engines. たとえば、「 Microsoft docs 」のように入力します。For example, Microsoft docs.

    • [Keyword](キーワード) : この検索エンジンをアクティブにするためにアドレス バーで使用する短い用語を指定します。Keyword: Specify a short term to use in the address bar to activate this search engine. たとえば、「 memdocs 」のように入力します。For example, memdocs.

    • [URL with %s in place of query](クエリの代わりに %s を含む URL) : 例:URL with %s in place of query: For example,

      https://docs.microsoft.com/en-us/search/index?search=%s&scope=ConfigMgr
      

      注意

      この例は、ConfigMgr スコープに固有のものです。This example is specific to the ConfigMgr scope. スコープ変数を削除してすべての docs.microsoft.com を検索したり、別のスコープを使用したりすることができます。You can remove the scope variable to search all docs.microsoft.com or use a different scope.

      Microsoft Docs の検索エンジンの場合、アドレスにロケールが必要です。The Microsoft Docs search engine requires a locale in the address. たとえば、「 en-us 」のように入力します。For example, en-us. 別のロケールを使用するようにエントリを変更することができます。You can change your entry to use a different locale.

    Microsoft Edge に Microsoft Docs 用のカスタム検索エンジンを追加する

この検索エンジンを追加した後、ブラウザーのアドレス バーにキーワードを入力して Tab キーを押し、検索語句を入力して、Enter キーを押します。After you add this search engine, type your keyword in the browser address bar, press Tab, then type your search terms, and press Enter. 定義されているスコープを使用して、指定した用語が Microsoft Docs で自動的に検索されます。It will automatically search Microsoft Docs for your specified terms using the defined scope.

フィードバックについてAbout feedback

記事の右上にある [フィードバック] リンクを選択し、一番下の [フィードバック] セクションに進みます。Select the Feedback link in the upper right of any article to go to the Feedback section at the bottom. 「フィードバック」は GitHub の Issue と統合されています。Feedback is integrated with GitHub Issues. この GitHub の Issue との統合の詳細については、ドキュメント プラットフォームに関するブログ記事を参照してください。For more information about this integration with GitHub Issues, see the docs platform blog post.

ドキュメント記事の [フィードバック] セクションのスクリーンショット

製品自体に関するドキュメント以外のフィードバックを共有するには、 [この製品] を選択してください。To share non-docs feedback about the product itself, select This product. この操作により、その製品の UserVoice サイトが開きます。This action opens the product's UserVoice site.

現在の記事に関するドキュメントのフィードバックを共有するには、 [このページ] を選択してください。To share docs feedback about the current article, select This page. ドキュメントに関するフィードバックを送信するには、GitHub アカウントが必要です。A GitHub account is a prerequisite for providing documentation feedback. サインイン後、MicrosoftDocs 組織の 1 回限りの承認を受けます。Once you sign in, there's a one-time authorization for the MicrosoftDocs organization. これにより、GitHub の新しい問題入力フォームが開きます。It then opens the GitHub new issue form. 本文にわかりやすいタイトルとフィードバックの詳細を追加します。ただし、[ドキュメントの詳細] セクションは変更しないでください。Add a descriptive title and detailed feedback in the body, but don't modify the document details section. 次に、 [Submit new issue](新しいイシューの送信) を選択して、MEMDocs GitHub リポジトリの対象の記事に新しい問題を投稿します。Then select Submit new issue to file a new issue for the target article in the MEMDocs GitHub repository.

この記事に関するフィードバックが既にあるかどうかを確認するには、 [すべてのページ フィードバックを表示] を選択します。To see whether there's already feedback for this article, select View all page feedback. この操作により、GitHub のこの記事に関連する問題のクエリ画面が開きます。This action opens a GitHub issue query for this article. 既定では、未解決の問題とクローズされた問題の両方が表示されます。By default it displays both open and closed issues. 新しい問題を送信する前に、既存のフィードバックを確認してください。Review any existing feedback before you submit a new issue. 関連する問題が見つかった場合は、顔アイコンを選択して反応を追加し、スレッドにコメントを追加できるほか、 [Subscribe](サブスクライブ) を選択して通知を受け取るよう設定できます。If you find a related issue, select the face icon to add a reaction, add a comment to the thread, or Subscribe to receive notifications.

フィードバックの種類Types of feedback

GitHub Issues を使用し、次の種類のフィードバックを送信します。Use GitHub Issues to submit the following types of feedback:

  • ドキュメント バグ:内容が古い、はっきりしない、紛らわしい、あるいは不完全です。Doc bug: The content is out of date, unclear, confusing, or broken.
  • ドキュメント改善:記事を良くするための提案。Doc enhancement: A suggestion to improve the article.
  • ドキュメント質問:既存のドキュメントが見つからず、困っています。Doc question: You need help with finding existing documentation.
  • ドキュメント アイデア:新しい記事の提案。Doc idea: A suggestion for a new article. ドキュメントに関するフィードバックとして、UserVoice の代わりにこの方法を使用します。Use this method instead of UserVoice for documentation feedback.
  • 称賛:情報が役立った記事に関する好意的なフィードバック。Kudos: Positive feedback about a helpful or informative article!
  • ローカリゼーション:コンテンツの翻訳に関するフィードバック。Localization: Feedback about content translation.
  • 検索エンジン最適化 (SEO):コンテンツを検索できない問題に関するフィードバック。Search engine optimization (SEO): Feedback about problems searching for content. コメントには、検索エンジン、キーワード、対象記事を含めます。Include the search engine, keywords, and target article in the comments.

ドキュメントに関連しないイシューを作成した場合、Microsoft はそのイシューをクローズし、より適切なフィードバック チャネルにリダイレクトします。If you create an issue for something not related to docs, Microsoft will close the issue and redirect you to a better feedback channel. 次に例を示します。For example:

基本的な docs.microsoft.com プラットフォームに関するフィードバックを投稿するには、ドキュメント フィードバックに関するページをご覧ください。To share feedback on the fundamental docs.microsoft.com platform, see Docs feedback. このプラットフォームには、見出し、目次、右側のメニューなど、すべてのラッパー コンポーネントが含まれています。The platform includes all of the wrapper components such as the header, table of contents, and right menu. また、フォント、アラート ボックス、ページ アンカーなど、ブラウザーで記事をレンダリングする方法も含まれています。Also how the articles render in the browser, such as the font, alert boxes, and page anchors.

通知Notifications

ドキュメント ライブラリの内容が変わったときに通知を受け取るには、次の手順を使用します。To receive notifications when content changes in the documentation library, use the following steps:

  1. ドキュメント検索を使用し、1 件または一連の記事を見つけます。Use the docs search to find an article or set of articles. 次に例を示します。For example:

    • 1 つの記事をタイトル "Microsoft Intune の新機能 - Azure" で検索するSearch for a single article by title, "What's new in Microsoft Intune - Azure"

      ヒント

      1 つの記事検索を 1 つの記事に絞り込むには、docs.microsoft.com の検索結果に表示される完全なタイトルを使用します。To refine a single article search to a single article, use the full title that displays in the docs.microsoft.com search results. このタイトルがブラウザーのタブに表示されるタイトルです。This title is what appears in the browser tab.

    • BitLocker に関する Configuration Manager の記事を検索するSearch for any Configuration Manager article about BitLocker

  2. 結果の一覧の下部にある [RSS] リンクを選択します。At the bottom of the list of results, select the RSS link.

    検索結果と [RSS] リンクのスクリーンショット

  3. あらゆる RSS アプリケーションでこのフィードを利用し、検索結果に変更があったときに通知を受け取ることができます。Use this feed in any RSS application to receive notifications when there's a change to any of the search results.

このコンテンツ ライブラリの人気の記事のいくつかは最上部にヒントがあり、RSS フィードへのリンクが既に作成されています。Several popular articles in this content library have a tip at the top with a ready-made link to the RSS feed.

ヒント

また、GitHub 上の MEMDocs リポジトリウォッチする こともできます。You can also Watch the MEMDocs repository on GitHub. この方法では、"多数の" 通知が生成される場合があります。This method can generate many notifications. また、Microsoft によって使用されるプライベート リポジトリからの変更は含まれません。It also doesn't include changes from the private repository that Microsoft uses.

投稿Contribute

Microsoft エンドポイント マネージャー ドキュメント ライブラリは、docs.microsoft.com のほとんどのコンテンツと同様に、GitHub ではオープンソースになっています。The Microsoft Endpoint Manager documentation library, like most content on docs.microsoft.com, is open-sourced on GitHub. このライブラリは、コミュニティの寄稿を受け入れ、奨励しています。This library accepts and encourages community contributions. 概要については、投稿に関するガイド ページをご覧ください。For more information on how to get started, see the Contributor Guide. GitHub アカウントの作成が唯一の前提条件です。The only prerequisite is to create a GitHub account.

投稿するための基本手順Basic steps to contribute

  1. 対象の記事で、右上隅にある [編集] を選択します。From the target article, select Edit in the upper right corner. GitHub でソース ファイルが開きます。This action opens the source file in GitHub.

  2. ソース ファイルを編集するには、鉛筆アイコンを選択します。To edit the source file, select the pencil icon.

    GitHub ソース ファイル ヘッダーのスクリーンショット

  3. マークダウン ソースで変更を加えます。Make changes in the markdown source. 詳細については、「How to use Markdown for writing Docs」 (ドキュメントの記述にマークダウンを使用する方法) を参照してください。For more information, see How to use Markdown for writing Docs.

  4. ファイル変更の提案セクションで、公開コミット コメントを入力し、自分が "変更した内容" を説明します。In the Propose file change section, enter the public commit comment describing what you changed. [Propose file change](ファイル変更の提案) を選択します。Then select Propose file change.

  5. 下にスクロールし、行った変更を確認します。Scroll down and verify the changes you made. [pull request の作成] を選択し、フォームを開きます。Select Create pull request to open the form. この変更を行った "理由" を説明します。Describe why you made this change. [pull request の作成] を選択します。Select Create pull request.

文書作成チームがあなたのプル要求を受け取り、それを適切なライターに割り当てます。The writing team receives your pull request, and assigns it to the appropriate writer. 作成者はテキストをレビューし、それに手早く編集を加えます。The author reviews the text, and does a quick edit pass on it. それらの人々が変更を承認してマージするか、更新の詳細情報についてあなたに問い合わせます。They'll either approve and merge the changes, or contact you for more information about the update.

貢献できることWhat to contribute

投稿したいがどこから始めればよいかわからない場合は、以下の提案をご覧ください。If you want to contribute, but don't know where to start, see the following suggestions:

  • 記事の正しさを確認します。Review an article for accuracy. mm/dd/yyyy 形式で ms.date メタデータを更新します。Then update the ms.date metadata using mm/dd/yyyy format. このような貢献によって、コンテンツが新しい状態で維持されます。This contribution helps keep the content fresh.

  • 自分の経験に基づき、説明、例、手本を追加します。Add clarifications, examples, or guidance based on your experience. このような貢献によって、コミュニティの力が利用され、知識が共有されます。This contribution uses the power of the community to share knowledge.

  • 英語以外の言語の翻訳を訂正します。Correct translations in a non-English language. このような貢献によって、ローカライズされたコンテンツの有用性が上がります。This contribution improves the usability of localized content.

  • 問題の一覧を見て、コミュニティ宛てのラベルを探します。Search the list of issues for the community-targeted labels:

    • good first issuegood first issue

    • help wantedhelp wanted

      Microsoft の作成者は、コミュニティの投稿が求められる問題に対してこれらのラベルを割り当てることができます。Microsoft authors can assign these labels to issues that are good candidates for community contribution. これらは主に、Configuration Manager PowerShell ドキュメントで使用されます。They're primarily used for Configuration Manager PowerShell docs.

注意

Microsoft の従業員でない場合、規模の大きい投稿を行うには貢献者使用許諾契約書 (CLA) に署名する必要があります。Large contributions require signing a Contribution License Agreement (CLA) if you aren't a Microsoft employee. GitHub では、投稿がしきい値に達すると自動的にこの契約への署名が求められます。GitHub automatically requires you to sign this agreement when a contribution meets the threshold. この契約に署名する必要があるのは 1 回だけです。You only need to sign this agreement once.

投稿に関するヒントContribution tips

投稿するときは、次のガイドライン全般に従ってください。Follow these general guidelines when you contribute:

(この一覧は、.NET の投稿に関するガイドから借用されたものです。)(This list was borrowed from the .NET contributing guide.)