forked from GouNiNi/azure-docs.fr-fr
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
open localization: commit translated files
- Loading branch information
1 parent
49bca90
commit c430194
Showing
1 changed file
with
59 additions
and
50 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,83 +1,92 @@ | ||
# Guide du contributeur à la documentation technique Azure | ||
Vous avez trouvé le dépôt GitHub qui héberge la source de la documentation technique publiée dans le Centre de documentation Azure à l’adresse [http://azure.microsoft.com/documentation](http://azure.microsoft.com/documentation). | ||
# <a name="azure-technical-documentation-contributor-guide"></a>Guide du contributeur à la documentation technique Azure | ||
Vous avez trouvé le dépôt GitHub qui héberge la source de la documentation technique publiée dans le Centre de documentation Azure à l’adresse [http://docs.microsoft.com/azure](http://docs.microsoft.com/azure). | ||
|
||
Ce dépôt contient également des conseils pour vous aider à contribuer à notre documentation technique. Pour obtenir la liste des articles contenus dans le guide du contributeur, consultez [l’index](https://github.com/Azure/azure-content/blob/master/contributor-guide/contributor-guide-index.md). | ||
Ce dépôt contient également des conseils pour vous aider à contribuer à notre documentation technique. Pour obtenir la liste des articles dans le guide du contributeur, consultez l’[index](contributor-guide/contributor-guide-index.md). | ||
|
||
## Contribuer à la documentation Azure | ||
## <a name="contribute-to-azure-documentation"></a>Contribuer à la documentation Azure | ||
Merci de l’intérêt que vous portez à la documentation Azure. | ||
|
||
* [Comment contribuer ?](#ways-to-contribute) | ||
* [Comment contribuer ?](#ways-to-contribute) | ||
* [Code de conduite](#code-of-conduct) | ||
* [À propos de vos contributions au contenu Azure](#about-your-contributions-to-azure-content) | ||
* [Organisation du dépôt](#repository-organization) | ||
* [Utiliser GitHub, Git et ce dépôt](#use-github-git-and-this-repository) | ||
* [Comment utiliser Markdown pour mettre en forme votre rubrique](#how-to-use-markdown-to-format-your-topic) | ||
* [Autres ressources](#Autres ressources) | ||
* [Index de tous les articles du guide du contributeur](https://github.com/Azure/azure-content/blob/master/contributor-guide/contributor-guide-index.md) (ouvre une nouvelle page) | ||
* [Retour d’information, commentaires et support](./contributor-guide/feedback-and-comments.md) | ||
* [Autres ressources](#more-resources) | ||
* [Index de tous les articles du guide du contributeur](contributor-guide/contributor-guide-index.md) (ouvre une nouvelle page) | ||
|
||
## Comment contribuer ? | ||
Vous pouvez facilement contribuer aux articles techniques dans l’interface utilisateur de GitHub. Recherchez l’article dans ce dépôt ou consultez l’article à l’adresse [http://azure.microsoft.com/documentation](http://azure.microsoft.com/documentation) et cliquez sur le lien dans l’article qui mène à la source GitHub de l’article. | ||
## <a name="ways-to-contribute"></a>Comment contribuer ? | ||
Pour envoyer des mises à jour de la [documentation Azure](http://docs.microsoft.com/azure), procédez comme suit : | ||
|
||
## À propos de vos contributions au contenu Azure | ||
### Corrections mineures | ||
Les corrections mineures ou les clarifications que vous soumettez pour la documentation, ainsi que les exemples de code dans ce dépôt, sont couverts par les [Conditions d’Utilisation du Site Web Microsoft Azure](http://azure.microsoft.com/support/legal/website-terms-of-use/). | ||
* Vous pouvez facilement contribuer aux articles techniques dans l’interface utilisateur de GitHub. Recherchez l’article dans ce dépôt ou consultez l’article à l’adresse [http://docs.microsoft.com/azure](http://docs.microsoft.com/azur) et cliquez sur le lien dans l’article qui mène à la source GitHub de l’article. | ||
* Si vous apportez des modifications substantielles à un article existant, si vous ajoutez ou modifiez des images ou si vous ajoutez un nouvel article, vous devez forker ce dépôt, installer GitBash et MarkdownPad, puis apprendre à utiliser certaines commandes git. | ||
|
||
### Corrections majeures | ||
Si vous envoyez une requête de tirage avec des ajouts ou d’importantes modifications de la documentation et des exemples de code, nous vous enverrons un commentaire dans GitHub pour vous inviter à soumettre un contrat de licence de contribution en ligne si vous appartenez à l’un de ces groupes : | ||
## <a name="code-of-conduct"></a>Code de conduite | ||
Ce projet a adopté le [Code de conduite open source de Microsoft](https://opensource.microsoft.com/codeofconduct/). Pour plus d’informations, consultez la [FAQ sur le code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou envoyez vos questions ou vos commentaires à [[email protected]](mailto:[email protected]). | ||
|
||
* Membres du groupe Microsoft Open Technologies | ||
* Contributeurs qui ne travaillent pour Microsoft | ||
## <a name="about-your-contributions-to-azure-content"></a>À propos de vos contributions au contenu Azure | ||
### <a name="minor-corrections"></a>Corrections mineures | ||
Les corrections mineures ou les clarifications que vous soumettez pour la documentation, ainsi que les exemples de code dans ce dépôt, sont couvertes par les [Conditions d’utilisation du site web docs.microsoft.com](/enterprise-mobility-security/termsofuse). | ||
|
||
Vous devrez remplir le formulaire en ligne pour que nous puissions accepter votre requête de tirage. | ||
### <a name="larger-submissions"></a>Corrections majeures | ||
Si vous envoyez une demande de tirage avec des ajouts ou d’importantes modifications de la documentation et des exemples de code, nous vous enverrons un commentaire dans GitHub pour vous inviter à signer un contrat de licence de contribution en ligne si vous n’êtes pas un employé de Microsoft. Vous devrez remplir le formulaire en ligne pour que nous puissions accepter votre demande de tirage (pull request). | ||
|
||
Tous les détails sont disponibles à l’adresse [http://azure.github.io/guidelines.html#cla](http://azure.github.io/guidelines.html#cla). | ||
## <a name="repository-organization"></a>Organisation du dépôt | ||
Le contenu du dépôt azure-docs suit l’organisation de la documentation sur http://docs.microsoft.com/azure. Ce dépôt contient deux dossiers racines : | ||
|
||
## Organisation du dépôt | ||
Le contenu du dépôt azure-content suit l’organisation de la documentation sur [Azure.Microsoft.com](http://azure.microsoft.com). Ce dépôt contient deux dossiers racines : | ||
### <a name="articles"></a>\articles | ||
Le dossier *\articles* contient les articles de la documentation au format de fichiers Markdown avec une extension *.md*. En général, les articles sont regroupés par service Azure. | ||
|
||
### \articles | ||
Le dossier *\articles* contient les articles de la documentation mis en forme en tant que fichiers Markdown avec une extension *.md*. | ||
Les articles doivent respecter les instructions d’affectation de noms de fichier. Pour plus d’informations, consultez [nos instructions d’affectation de noms de fichier](contributor-guide/file-names-and-locations.md). | ||
|
||
Les articles du répertoire racine sont publiés dans Azure.Microsoft.com. Chemin : http://azure.microsoft.com/documentation/articles/{article-name-without-md}/ | ||
Le dossier *\articles* contient le dossier *\media* des fichiers multimédias des articles du répertoire racine, lequel contient les sous-dossiers comprenant les images de chaque article. Les dossiers de service contiennent un dossier de fichiers multimédias distinct pour les articles dans chaque dossier de service. Le dossier d’images d’un article porte le même nom que le fichier de l’article, moins l’extension de fichier *.md* . | ||
|
||
* **Noms de fichier des articles :** consultez [nos instructions sur l’affectation des noms de fichier](https://github.com/Azure/azure-content/blob/master/contributor-guide/file-names-and-locations.md). | ||
### <a name="includes"></a>\includes | ||
Vous pouvez créer des sections de contenu réutilisables à inclure dans un ou plusieurs articles. Consultez [Extensions personnalisées utilisées dans notre contenu technique](contributor-guide/custom-markdown-extensions.md). | ||
|
||
Les articles dans leur propre dossier de service sont publiés dans Azure.Microsoft.com. Chemin : | ||
*http://azure.microsoft.com/documentation/articles/service-folder/{article-name-without-md}/* | ||
|
||
* **Sous-dossiers de fichiers multimédias :** le dossier *\articles* contient le dossier *\media* pour les fichiers multimédias des articles du répertoire racine, à l’intérieur duquel figurent des sous-dossiers contenant les images de chaque article. Les dossiers de service contiennent un dossier de fichiers multimédias distinct pour les articles dans chaque dossier de service. Le dossier d’images d’un article porte le même nom que le fichier de l’article, moins l’extension de fichier *.md*. | ||
|
||
### \includes | ||
Vous pouvez créer des sections de contenu réutilisables à inclure dans un ou plusieurs articles. Consultez [Extensions personnalisées utilisées dans notre contenu technique](https://github.com/Azure/azure-content/blob/master/contributor-guide/custom-markdown-extensions.md). | ||
|
||
### \markdown templates | ||
### <a name="markdown-templates"></a>\markdown templates | ||
Ce dossier contient notre modèle Markdown standard avec la mise en forme Markdown de base dont vous avez besoin pour un article. | ||
|
||
### \contributor-guide | ||
Ce dossier contient des articles qui font partie de notre guide du contributeur. | ||
### <a name="contributorguide"></a>\contributor-guide | ||
Ce dossier contient des articles qui font partie de notre guide du contributeur. | ||
|
||
## Utiliser GitHub, Git et ce dépôt | ||
Pour plus d’informations sur la façon de contribuer, d’utiliser l’interface utilisateur de GitHub pour apporter des modifications mineures, et de répliquer et cloner le dépôt pour effectuer des contributions majeures, consultez [Installer et configurer les outils de création dans GitHub](https://github.com/Azure/azure-content/blob/master/contributor-guide/tools-and-setup.md). | ||
## <a name="use-github-git-and-this-repository"></a>Utiliser GitHub, Git et ce dépôt | ||
Pour plus d’informations sur la façon de contribuer, d’utiliser l’interface de GitHub pour apporter des modifications mineures, et de forker et cloner le dépôt pour effectuer des contributions majeures, consultez [Installer et configurer les outils de création dans GitHub](contributor-guide/tools-and-setup.md). | ||
|
||
Si vous installez GitBash et que vous choisissez de travailler localement, les étapes permettant de créer une branche de travail locale, d’apporter des modifications et de les renvoyer vers la branche principale sont répertoriées dans [Commandes Git pour créer un article ou mettre à jour un article existant](https://github.com/Azure/azure-content/blob/master/contributor-guide/git-commands-for-master.md). | ||
Si vous installez GitBash et que vous choisissez de travailler localement, les étapes permettant de créer une branche de travail locale, d’apporter des modifications et de les renvoyer vers la branche principale sont répertoriées dans [Commandes Git pour créer un article ou mettre à jour un article existant](contributor-guide/git-commands-for-master.md) | ||
|
||
### Branches | ||
Nous vous recommandons de créer des branches de travail locales qui ciblent une étendue de modification spécifique. Chaque branche doit être limitée à un seul article/concept, à la fois pour rationaliser le flux de travail et pour réduire les risques de conflits de fusion. Les opérations appropriées pour une nouvelle branche sont les suivantes : | ||
### <a name="branches"></a>Branches | ||
Nous vous recommandons de créer des branches de travail locales qui ciblent une étendue de modification spécifique. Chaque branche doit être limitée à un seul article/concept, à la fois pour rationaliser le flux de travail et pour réduire les risques de conflits de fusion. Les opérations appropriées pour une nouvelle branche sont les suivantes : | ||
|
||
* Nouvel article (et images associées) | ||
* Corrections de la grammaire et de l’orthographe dans un article | ||
* Application d’une seule modification de mise en forme dans un grand nombre d’articles (par exemple nouveau pied de page de copyright) | ||
|
||
## Comment utiliser Markdown pour mettre en forme votre rubrique | ||
Tous les articles dans ce dépôt font appel à Markdown dans GitHub. Voici une liste de ressources. | ||
## <a name="how-to-use-markdown-to-format-your-topic"></a>Comment utiliser Markdown pour mettre en forme votre rubrique | ||
Tous les articles dans ce dépôt font appel à Markdown dans GitHub. Voici une liste de ressources. | ||
|
||
* [Les bases de Markdown](https://help.github.com/articles/markdown-basics/) | ||
* [Fiche récapitulative imprimable sur Markdown](./contributor-guide/media/documents/markdown-cheatsheet.pdf?raw=true) | ||
|
||
## <a name="article-metadata"></a>Métadonnées d’articles | ||
Les métadonnées d’articles permettent d’utiliser certaines fonctionnalités, telles que l’attribution de l’auteur, l’attribution du contributeur, les vues miniatures, les descriptions d’article, les optimisations du référencement d’un site auprès d’un moteur de recherche, ainsi que la création de rapports sur les processus utilisés par Microsoft pour évaluer les performances du contenu. Les métadonnées sont donc très importantes. [Voici quelques instructions qui vous aideront à optimiser vos métadonnées](contributor-guide/article-metadata.md). | ||
|
||
### <a name="labels"></a>Étiquettes | ||
Les étiquettes automatisées sont affectées à des demandes de tirage pour nous aider à gérer ces opérations et à vous informer sur l’état de vos demandes : | ||
|
||
* Contrat de licence de contribution associé | ||
* CLA-not-required : la modification est relativement mineure et ne nécessite pas la signature d’un CLA. | ||
* CLA-required : l’ampleur de la modification est relativement importante et requiert la signature d’un CLA. | ||
* CLA-signed : le contributeur a signé le CLA et la demande de tirage peut maintenant être examinée. | ||
* Étiquettes de pilier : les étiquettes de type PnP, Applications modernes et TDC identifient les demandes de tirage en fonction de l’organisation interne qui doit examiner la demande. | ||
* Modification envoyée à l’auteur : l’auteur a été informé de la demande de tirage en attente. | ||
|
||
## <a name="more-resources"></a>Autres ressources | ||
Pour découvrir toutes nos rubriques d’aide, consultez l’[index du guide du contributeur](contributor-guide/contributor-guide-index.md). | ||
|
||
* [Principes fondamentaux de Markdown](https://help.github.com/articles/markdown-basics/) | ||
* [Fiche récapitulative imprimable sur Markdown](https://github.com/Azure/azure-content/blob/master/contributor-guide/media/documents/markdown-cheatsheet.pdf?raw=true) | ||
* Pour obtenir notre liste d’éditeurs Markdown, consultez la rubrique sur [les outils et l’installation](https://github.com/Azure/azure-content/blob/master/contributor-guide/tools-and-setup.md#install-a-markdown-editor). | ||
|
||
## Métadonnées d’articles | ||
Les métadonnées d’articles activent certaines fonctionnalités sur le site web azure.microsoft.com, telles que l’attribution de l’auteur, l’attribution du contributeur, les vues miniatures, les descriptions des articles et les optimisations du référencement d’un site auprès d’un moteur de recherche, ainsi que la création de rapports Microsoft pour évaluer les performances du contenu. Les métadonnées sont donc très importantes. [Voici quelques instructions qui vous aideront à optimiser vos métadonnées](https://github.com/Azure/azure-content/blob/master/contributor-guide/article-metadata.md). | ||
|
||
## Autres ressources | ||
Pour découvrir toutes nos rubriques d’aide, consultez l’[index du guide du contributeur](https://github.com/Azure/azure-content/blob/master/contributor-guide/contributor-guide-index.md). | ||
<!--HONumber=Nov16_HO3--> | ||
|
||
<!-----HONumber=AcomDC_0307_2016--> | ||
|