diff options
Diffstat (limited to 'files/fr/mdn/guidelines/does_this_belong_on_mdn/index.md')
-rw-r--r-- | files/fr/mdn/guidelines/does_this_belong_on_mdn/index.md | 87 |
1 files changed, 87 insertions, 0 deletions
diff --git a/files/fr/mdn/guidelines/does_this_belong_on_mdn/index.md b/files/fr/mdn/guidelines/does_this_belong_on_mdn/index.md new file mode 100644 index 0000000000..a2355886d6 --- /dev/null +++ b/files/fr/mdn/guidelines/does_this_belong_on_mdn/index.md @@ -0,0 +1,87 @@ +--- +title: Ceci a-t-il sa place sur MDN ? +slug: MDN/Guidelines/Does_this_belong_on_MDN +tags: + - Guide + - Guidelines + - MDN Meta +translation_of: MDN/Guidelines/Does_this_belong_on_MDN +--- +<div>{{MDNSidebar}}</div> + +<p>Dans cet article, nous verrons comment décider de si un sujet ou un type de contenu doit être documenté sur MDN. Nous verrons également les autres emplacements où ce contenu pourra résider.</p> + +<h2 id="The_question">La question</h2> + +<p>Si vous préparez la documentation d'un sujet, vous vous demandez peut-être si sa place est sur MDN. Vous envisagez peut-être de maintenir la documentation dans votre code source ou de publier sur le <a href="https://wiki.mozilla.org/">wiki de Mozilla</a> ou dans les fichiers README d'un dépôt Git. Voyons quelles sont les meilleures options pour votre contenu.</p> + +<p>Les deux aspects principaux qui permettent de déterminer si un contenu a sa place sur MDN sont :</p> + +<ul> + <li>Le sujet du document (de quoi il s'agit)</li> + <li>La nature du document (de quel type de document il s'agit)</li> +</ul> + +<p>Attention, toute contribution à MDN s'inscrit avec des licences open source. Celles-ci sont <a href="/fr/docs/MDN/About#copyrights_and_licenses">décrites en détail</a> dans notre <a href="/fr/docs/MDN/About">page À propos de MDN</a>.</p> + +<div class="note"> +<p><strong>Note :</strong> Les <a href="https://www.mozilla.org/fr/about/legal/terms/mozilla/">Conditions d'utilisation des sites web et de communication</a> de Mozilla s'appliquent lorsque vous contribuez à MDN. Lisez ce document pour connaître ce qui peut et ce qui ne peut pas être publié sur les sites de Mozilla.</p> +</div> + +<h2 id="What_topics_belong_on_MDN_Web_Docs">Ce qui a sa place sur MDN</h2> + +<p>En général, MDN est utilisé pour documenter les technologies web open source. Cela comprend toute fonctionnalité qui peut être utilisée par les développeuses et développeurs web afin de créer des sites et des applications web. S'il s'agit d'une fonctionnalité implémentée par plusieurs navigateurs et spécifiée de façon standard ou en voie de standardisation, alors sa documentation a pleinement sa place sur MDN. S'il s'agit d'une fonctionnalité expérimentale et qui n'est pas implémentée dans plusieurs navigateurs ou qui est sujette à modification alors elle pourra être documentée mais ne sera pas forcément priorisée.</p> + +<p>Les sujets majeurs de MDN sont les technologies web côté client :</p> + +<ul> + <li><a href="/fr/docs/Web/HTML">HTML</a></li> + <li><a href="/fr/docs/Web/CSS">CSS</a></li> + <li><a href="/fr/docs/Web/JavaScript">JavaScript</a></li> + <li><a href="/fr/docs/Web/SVG">SVG</a></li> + <li><a href="/fr/docs/Web/API">Les API Web</a></li> + <li><a href="/fr/docs/Web/API/WebGL_API">WebGL</a></li> + <li>etc.</li> +</ul> + +<div class="note"> +<p><strong>Note :</strong> Les technologies côté serveur sont généralement documentées autre part et cette documentation n'est pas remplacée par MDN, mais il existe <a href="/fr/docs/Learn/Server-side">quelques exceptions</a>.</p> +</div> + +<p>Les sujets relatifs au développement web et qui portent sur différentes technologies sont également les bienvenus sur MDN :</p> + +<ul> + <li><a href="/fr/docs/Web/Accessibility">Accessibilité</a></li> + <li><a href="/fr/docs/Web/Guide/AJAX">AJAX</a></li> + <li><a href="/fr/docs/Web/Guide/Graphics">Graphisme sur le Web</a></li> + <li><a href="/fr/docs/Web/Progressive_web_apps">Applications web progressives (PWA)</a></li> + <li><a href="/fr/docs/Games">Jeux sur le Web</a></li> +</ul> + +<div class="note notecard"> +<p><strong>Note :</strong> MDN documente certaines fonctionnalités non-standard lorsqu'elles sont exposées sur le Web et que leur usage est important (comme les propriétés CSS spécifiques à WebKit par exemple). MDN documente également certaines technologies standard, hors du Web, si celles-ci s'avèrent utiles aux développeuses et développeurs web : voir <a href="/fr/docs/Related">la section sur les technologies connexes au Web</a>.</p> +</div> + +<h2 id="What_topics_dont_belong_on_MDN_Web_Docs">Ce qui n'a pas sa place sur MDN</h2> + +<p>De façon générale, tout ce qui n'est pas décrit par un standard ouvert du Web n'appartient pas à MDN. Cette section indique quelques règles complémentaires.</p> + +<h3 id="Mozilla_products">Produits Mozilla</h3> + +<p>Le contenu de MDN portait auparavant également sur les produits de Mozilla. Cette documentation a été migrée vers d'autres projets :</p> + +<ul> + <li><a href="https://firefox-source-docs.mozilla.org/">La documentation relative au développement de Firefox</a></li> + <li><a href="https://firefox-dev.tools/">La documentation relative aux outils de développement web (devtools) dans Firefox</a></li> + <li><a href="https://extensionworkshop.com">La documentation des extensions pour tout ce qui a trait à la publication dans Firefox</a></li> +</ul> + +<h3 id="What_else">Quoi d'autre ?</h3> + +<p>Voici d'autres exemples de sujets inappropriés pour MDN :</p> + +<ul> + <li>Les technologies non exposées au web et spécifique à un navigateur en particulier.</li> + <li>Les technologies qui ne sont pas relatives au Web.</li> + <li>La documentation des produits Mozilla à destination des utilisatrices et utilisateurs finaux qui ont leur place <a href="https://support.mozilla.org">sur le site de support Mozilla</a>.</li> +</ul>
\ No newline at end of file |