Guide pratique pour utiliser la documentationHow to use the docs

Cet article fournit des ressources et des conseils sur l’utilisation de la bibliothèque de documentation Configuration Manager.This article provides resources and tips for using the Microsoft Endpoint Manager documentation library. Il s’applique à Configuration Manager, Microsoft Intune et Autopilot et couvre les sujets suivants :It applies to Configuration Manager, Microsoft Intune, and Autopilot, and covers the following areas:

  • Comment effectuer une rechercheHow to search
  • Soumission de bogues, d’améliorations, de questions et de nouvelles idées concernant la documentationSubmitting doc bugs, enhancements, questions, and new ideas
  • Comment être notifié des changements apportésHow to get notified of changes
  • Comment contribuer à la documentationHow to contribute to docs

Pour obtenir de l'aide et une assistance générales, consultez :For general help and support, see:

Conseil

Visitez également le nœud Documentation dans l’espace de travail Communauté de la console Configuration Manager.Also visit the Documentation node in the Community workspace of the Configuration Manager console. Ce nœud contient des informations à jour sur la documentation et les articles de support Configuration Manager.This node includes up-to-date information about Configuration Manager documentation and support articles. Pour plus d’informations, consultez Utilisation de la console Configuration Manager.For more information, see Using the Configuration Manager console.

Les informations contenues dans cet article s’appliquent également à la documentation PowerShell Configuration Manager dans le référentiel sccm-docs-powerShell-ref.Information in this article also applies to the Configuration Manager PowerShell documentation in the sccm-docs-powershell-ref repository.

Suivez les conseils de recherche ci-après pour trouver les informations dont vous avez besoin :Use the following search tips to help you find the information that you need:

  • Quand vous utilisez votre moteur de recherche favori pour rechercher du contenu, ajoutez un mot clé à vos mots clés de recherche.When using your preferred search engine to locate content, include a keyword along with your search keywords. Par exemple, ConfigMgr pour Configuration Manager et Intune pour Intune.For example, ConfigMgr for Configuration Manager and Intune for Intune.

    • Recherchez les résultats de docs.microsoft.com/mem.Look for results from docs.microsoft.com/mem. Les résultats obtenus à partir de docs.microsoft.com/previous-versions, technet.microsoft.com ou msdn.microsoft.com sont pour les versions de produits plus anciennes.Results from docs.microsoft.com/previous-versions, technet.microsoft.com, or msdn.microsoft.com are for older product versions.

    • Pour concentrer davantage les résultats de la recherche sur la bibliothèque de contenu actuelle, ajoutez site:docs.microsoft.com à votre requête afin de définir l’étendue à couvrir par le moteur de recherche.To further focus the search results to the current content library, include site:docs.microsoft.com in your query to scope the search engine.

  • Utilisez des termes de recherche correspondant à la terminologie qui se trouve dans l’interface utilisateur et la documentation en ligne.Use search terms that match terminology in the user interface and online documentation. Évitez les termes ou les abréviations non officiels que vous pouvez voir dans le contenu de la communauté.Avoid unofficial terms or abbreviations that you might see in community content. Par exemple, recherchez :For example, search for:

    • « point de gestion » plutôt que « MP » (Management Point)"management point" rather than "MP"
    • « type de déploiement » plutôt que « DT » (Deployment Type)"deployment type" rather than "DT"
    • « Extension de gestion Intune » plutôt que « IME »"Intune management extension" rather than "IME"
  • Pour effectuer une recherche dans l’article actuel, utilisez la fonctionnalité Rechercher de votre navigateur.To search within the current article, use your browser's Find feature. Dans la plupart des navigateurs web actuels, appuyez sur Ctrl+F, puis entrez vos termes de recherche.With most modern web browsers, press Ctrl+F and then enter your search terms.

  • Chaque article sur docs.microsoft.com inclut les champs suivants qui vous permettent d’effectuer des recherches dans le contenu :Each article on docs.microsoft.com includes the following fields to assist with searching the content:

    • Rechercher en haut à droite.Search in the upper right corner. Pour effectuer une recherche dans tous les articles, entrez des termes dans ce champ.To search all articles, enter terms in this field. Les Articles de cette bibliothèque de contenu incluent automatiquement l’une des étendues de recherche suivantes : ConfigMgr ou Intune.Articles in this content library automatically include one of the following search scopes: ConfigMgr or Intune.

      Champ de recherche de documents dans l’en-tête

    • Filtrer par titre au-dessus de la table des matières de gauche.Filter by title above the left table of contents. Pour effectuer une recherche dans la table des matières, entrez des termes dans ce champ.To search the current table of contents, enter terms in this field. Ce champ permet de rechercher uniquement les termes qui apparaissent dans les titres d’articles du nœud actuel.This field only matches terms that appear in the article titles for the current node. Par exemple, Infrastructure centrale Configuration Manager (docs.microsoft.com/mem/configmgr/core) ou Applications 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/). Le dernier élément des résultats de la recherche vous donne la possibilité de rechercher les termes dans la bibliothèque de contenu entière.The last item in the search results gives you the option to search for the terms in the entire content library.

      Animation de l’utilisation du filtre de la table des matières

Vous n’arrivez pas à trouver quelque chose ?Having problems finding something? Soumettez des commentaires !File feedback! Quand vous soumettez un problème relatif aux résultats de la recherche, indiquez le moteur de recherche utilisé, les mots clés essayés et l’article cible.When you file an issue about search results, provide the search engine you're using, the keywords you tried, and the target article. Ces commentaires aident Microsoft à optimiser le contenu pour une meilleure recherche.This feedback helps Microsoft optimize the content for better search.

Ajouter un moteur de recherche personnaliséAdd a custom search engine

Avec de nombreux navigateurs Web modernes, vous pouvez créer un moteur de recherche personnalisé.With many modern web browsers, you can create a custom search engine. Utilisez cette fonctionnalité pour rechercher rapidement et facilement docs.microsoft.com.Use this feature to quickly and easily search docs.microsoft.com. Par exemple, avec Microsoft Edge, version 77 et versions ultérieures, utilisez le processus suivant :For example, with Microsoft Edge, version 77 and later, use the following process:

  1. Dans Microsoft Edge, version 77 et ultérieures, ouvrez Paramètres.In Microsoft Edge, version 77 and later, open Settings.

  2. Dans le menu de gauche, sélectionnez Confidentialité, recherche et services.In the left menu, select Privacy, search, and services.

  3. Faites défiler vers le bas du groupe Services et sélectionnez barre d’adresses et recherche.Scroll to the bottom of the Services group and select Address bar and search.

  4. Sélectionnez Gérer les moteurs de recherche.Select Manage search engines.

  5. Sélectionnez Ajouter et spécifiez les informations suivantes :Select Add and specify the following information:

    • Moteur de recherche : Entrez un nom convivial pour l’identifier dans la liste des moteurs de recherche.Search engine: Enter a friendly name to identify it in the list of search engines. Par exemple : Microsoft docs.For example, Microsoft docs.

    • Mot clé : Spécifiez un terme court à utiliser dans la barre d’adresses pour activer ce moteur de recherche.Keyword: Specify a short term to use in the address bar to activate this search engine. Par exemple : memdocs.For example, memdocs.

    • URL avec %s à la place de la requête : Par exemple,URL with %s in place of query: For example,

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

      Notes

      Cet exemple est spécifique à l’étendue ConfigMgr.This example is specific to the ConfigMgr scope. Vous pouvez supprimer la variable d’étendue pour rechercher toutes les docs.microsoft.com ou utiliser une autre étendue.You can remove the scope variable to search all docs.microsoft.com or use a different scope.

      Le moteur de recherche Microsoft Docs requiert des paramètres régionaux dans l’adresse.The Microsoft Docs search engine requires a locale in the address. Par exemple : en-us.For example, en-us. Vous pouvez modifier votre entrée pour utiliser des paramètres régionaux différents.You can change your entry to use a different locale.

    Ajouter à Microsoft Edge un moteur de recherche personnalisé pour Microsoft Docs

Après avoir ajouté ce moteur de recherche, tapez votre mot clé dans la barre d’adresse du navigateur, appuyez sur Tab, tapez vos termes de recherche, puis appuyez sur 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. Il recherchera automatiquement Microsoft Docs pour les termes spécifiés, à l’aide de l’étendue définie.It will automatically search Microsoft Docs for your specified terms using the defined scope.

À propos des commentairesAbout feedback

Sélectionnez le lien Commentaires en haut à droite d’un article pour accéder à la section Commentaires située en bas.Select the Feedback link in the upper right of any article to go to the Feedback section at the bottom. Les commentaires sont intégrés aux problèmes GitHub.Feedback is integrated with GitHub Issues. Pour plus d’informations sur cette intégration aux problèmes GitHub, consultez le billet de blog consacré à la plateforme de documentation.For more information about this integration with GitHub Issues, see the docs platform blog post.

Capture d’écran de la section commentaires sur un article docs

Pour partager des commentaires hors document sur le produit lui-même, sélectionnez Ce produit.To share non-docs feedback about the product itself, select This product. Cette action ouvre le site UserVoice du produit.This action opens the product's UserVoice site.

Pour partager des commentaires sur l’article en cours, sélectionnez Cette page.To share docs feedback about the current article, select This page. Si vous souhaitez fournir des commentaires sur la documentation, la possession d’un compte GitHub est un prérequis.A GitHub account is a prerequisite for providing documentation feedback. Une fois que vous êtes connecté, vous disposez d’une autorisation à usage unique pour l’organisation MicrosoftDocs.Once you sign in, there's a one-time authorization for the MicrosoftDocs organization. Il ouvre ensuite le nouveau formulaire des problèmes GitHub.It then opens the GitHub new issue form. Ajoutez un titre descriptif et des commentaires détaillés dans le corps, mais ne modifiez pas la section Détails du document.Add a descriptive title and detailed feedback in the body, but don't modify the document details section. Sélectionnez ensuite Soumettre un nouveau problème pour signaler un nouveau problème pour l’article cible dans le référentiel MEMDocs GitHub.Then select Submit new issue to file a new issue for the target article in the MEMDocs GitHub repository.

Pour voir s’il existe déjà des commentaires pour cet article, sélectionnez Afficher tous les commentaires sur la page.To see whether there's already feedback for this article, select View all page feedback. Cette action ouvre une requête de problème GitHub pour cet article.This action opens a GitHub issue query for this article. Par défaut, il affiche à la fois des problèmes ouverts et fermés.By default it displays both open and closed issues. Consultez les commentaires existants avant de soumettre un nouveau problème.Review any existing feedback before you submit a new issue. Si vous trouvez un problème connexe, sélectionnez l’icône de visage pour ajouter une réaction, ajoutez un commentaire à la conversation ou S’abonner pour recevoir des notifications.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 de commentaireTypes of feedback

Utilisez la fonctionnalité Problèmes GitHub pour soumettre les types de commentaire suivants :Use GitHub Issues to submit the following types of feedback:

  • Bogue de documentation : le contenu est obsolète, vague, confus ou fragmenté.Doc bug: The content is out of date, unclear, confusing, or broken.
  • Amélioration de la documentation : suggestion d’amélioration de l’article.Doc enhancement: A suggestion to improve the article.
  • Question sur la documentation : vous avez besoin d’aide pour trouver de la documentation existante.Doc question: You need help with finding existing documentation.
  • Idée de documentation : suggestion d’un nouvel article.Doc idea: A suggestion for a new article. Utilisez cette méthode à la place de UserVoice pour les commentaires relatifs à la documentation.Use this method instead of UserVoice for documentation feedback.
  • Félicitations : commentaires positifs sur un article utile ou instructif !Kudos: Positive feedback about a helpful or informative article!
  • Localisation : commentaires sur la traduction du contenu.Localization: Feedback about content translation.
  • Optimisation du référencement d’un site auprès d’un moteur de recherche (SEO) : commentaires sur les problèmes de recherche de contenu.Search engine optimization (SEO): Feedback about problems searching for content. Incluez le moteur de recherche, les mots clés et l’article cible dans les commentaires.Include the search engine, keywords, and target article in the comments.

Si vous créez un problème pour un événement qui n’est pas lié aux documents, Microsoft ferme le problème et vous redirige vers un meilleur canal de commentaires.If you create an issue for something not related to docs, Microsoft will close the issue and redirect you to a better feedback channel. Exemple :For example:

Pour partager vos commentaires sur la plateforme principale docs.microsoft.com, consultez les commentaires sur la documentation.To share feedback on the fundamental docs.microsoft.com platform, see Docs feedback. La plateforme inclut tous les composants de wrapper tels que l’en-tête, la table des matières et le menu de droite.The platform includes all of the wrapper components such as the header, table of contents, and right menu. Elle inclut également le rendu des articles dans le navigateur, par exemple la police, les zones d’alerte et les ancres de page.Also how the articles render in the browser, such as the font, alert boxes, and page anchors.

NotificationsNotifications

Pour recevoir des notifications en cas de changement du contenu dans la bibliothèque de documentation, suivez les étapes ci-dessous :To receive notifications when content changes in the documentation library, use the following steps:

  1. Utilisez la recherche de documentation pour trouver un article ou un ensemble d’articles.Use the docs search to find an article or set of articles. Par exemple :For example:

    • Rechercher un seul article par titre, « Nouveautés dans Microsoft Intune-Azure »Search for a single article by title, "What's new in Microsoft Intune - Azure"

      Conseil

      Pour affiner la recherche d’un article dans un seul article, utilisez le titre complet qui s’affiche dans les résultats de la recherche 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. Ce titre s’affiche sous l’onglet Navigateur.This title is what appears in the browser tab.

    • Rechercher des articles Configuration Manager BitLockerSearch for any Configuration Manager article about BitLocker

  2. En bas de la liste des résultats, sélectionnez le lien RSS.At the bottom of the list of results, select the RSS link.

    Capture d’écran des résultats de la recherche et lien RSS

  3. Utilisez ce flux dans une application RSS pour recevoir des notifications en cas de changement de l’un des résultats de la recherche.Use this feed in any RSS application to receive notifications when there's a change to any of the search results.

Plusieurs articles populaires de cette bibliothèque de contenu ont un conseil en haut avec un lien prêt à l’emploi vers le flux RSS.Several popular articles in this content library have a tip at the top with a ready-made link to the RSS feed.

Conseil

Vous pouvez également Regarder le référentiel MEMDocs sur GitHub.You can also Watch the MEMDocs repository on GitHub. Cette méthode peut générer de nombreuses notifications.This method can generate many notifications. De plus, elle n’inclut pas les modifications apportées à un référentiel privé utilisé par Microsoft.It also doesn't include changes from the private repository that Microsoft uses.

CollaborationContribute

La bibliothèque de documentation Microsoft Endpoint Manager, comme la plupart du contenu de docs.microsoft.com, est open source sur GitHub.The Microsoft Endpoint Manager documentation library, like most content on docs.microsoft.com, is open-sourced on GitHub. Cette bibliothèque accepte et encourage les contributions de la communauté.This library accepts and encourages community contributions. Pour plus d’informations sur la procédure à suivre, consultez le Guide du contributeur.For more information on how to get started, see the Contributor Guide. Le seul prérequis est la création d’un compte GitHub.The only prerequisite is to create a GitHub account.

Étapes de base pour contribuerBasic steps to contribute

  1. Dans l’article cible, sélectionnez Modifier dans le coin supérieur droit.From the target article, select Edit in the upper right corner. Cette action permet d’ouvrir le fichier source dans GitHub.This action opens the source file in GitHub.

  2. Pour modifier le fichier source, sélectionnez l’icône de crayon.To edit the source file, select the pencil icon.

    Capture d’écran de l’en-tête du fichier source GitHub

  3. Apportez vos changements à la source Markdown.Make changes in the markdown source. Pour plus d’informations, consultez Guide pratique pour utiliser Markdown et rédiger de la documentation.For more information, see How to use Markdown for writing Docs.

  4. Dans la section Propose file change (Proposer le changement d’un fichier), entrez un commentaire de validation publique décrivant ce que vous avez changé.In the Propose file change section, enter the public commit comment describing what you changed. Sélectionnez ensuite Propose file change (Proposer le changement d’un fichier).Then select Propose file change.

  5. Faites défiler vers le bas et vérifiez les changements apportés.Scroll down and verify the changes you made. Sélectionnez Create pull request (Créer une demande de tirage (pull request)) pour ouvrir le formulaire.Select Create pull request to open the form. Indiquez pourquoi vous avez effectué ce changement.Describe why you made this change. Sélectionnez Create pull request (Créer une demande de tirage (pull request)).Select Create pull request.

L’équipe d’écriture reçoit votre demande de tirage (pull request) et l’attribue au writer approprié.The writing team receives your pull request, and assigns it to the appropriate writer. L’auteur évalue le texte et effectue un rapide transfert des modifications.The author reviews the text, and does a quick edit pass on it. Ils approuvent et fusionnent les modifications ou vous contactent pour obtenir plus d’informations sur la mise à jour.They'll either approve and merge the changes, or contact you for more information about the update.

Type de contributionWhat to contribute

Si vous voulez apporter votre contribution mais que vous ne savez pas par où commencer, consultez les suggestions suivantes :If you want to contribute, but don't know where to start, see the following suggestions:

  • Vérifiez l’exactitude d’un article.Review an article for accuracy. Mettez ensuite à jour les métadonnées ms.date au format mm/dd/yyyy.Then update the ms.date metadata using mm/dd/yyyy format. Ce type de contribution permet d’actualiser le contenu.This contribution helps keep the content fresh.

  • Ajoutez des éclaircissements, des exemples ou des conseils d’aide en fonction de votre expérience utilisateur.Add clarifications, examples, or guidance based on your experience. Ce type de contribution tire parti de la puissance de la communauté pour permettre le partage des connaissances.This contribution uses the power of the community to share knowledge.

  • Corrigez les traductions effectuées à partir de l’anglais.Correct translations in a non-English language. Ce type de contribution améliore la facilité d’utilisation du contenu localisé.This contribution improves the usability of localized content.

  • Recherchez dans la liste des problèmes les étiquettes destinées à la communauté :Search the list of issues for the community-targeted labels:

    • problème prioritairegood first issue

    • aide souhaitéehelp wanted

      Les auteurs Microsoft peuvent attribuer ces étiquettes aux problèmes qui sont de bons candidats pour une contribution à la communauté.Microsoft authors can assign these labels to issues that are good candidates for community contribution. Ils sont principalement utilisés pour des documents PowerShell Configuration Manager.They're primarily used for Configuration Manager PowerShell docs.

Notes

Les contributions importantes requièrent la signature d’un contrat de licence de contribution (CLA) si vous n’êtes pas un employé de Microsoft.Large contributions require signing a Contribution License Agreement (CLA) if you aren't a Microsoft employee. GitHub vous demande automatiquement de signer ce contrat quand une contribution atteint le seuil.GitHub automatically requires you to sign this agreement when a contribution meets the threshold. Vous ne devez signer ce contrat qu’une seule fois.You only need to sign this agreement once.

Conseils de contributionContribution tips

Suivez ces instructions générales pour contribuer :Follow these general guidelines when you contribute:

(Cette liste a été empruntée au guide de contribution .NET.)(This list was borrowed from the .NET contributing guide.)