Skip to content

Commit

Permalink
chore(sync): handle all merge conflicts (but not yet new pages)
Browse files Browse the repository at this point in the history
  • Loading branch information
tdd committed Feb 5, 2024
1 parent 61059ed commit 0ebbac6
Show file tree
Hide file tree
Showing 13 changed files with 143 additions and 204 deletions.
24 changes: 12 additions & 12 deletions .github/ISSUE_TEMPLATE/0-bug.yml
Original file line number Diff line number Diff line change
@@ -1,34 +1,34 @@
name: "🐛 Report a bug"
description: "Report a problem on the website."
name: "🐛 Signaler un bug"
description: "Signale un bug sur le site web."
title: "[Bug]: "
labels: ["bug: unconfirmed"]
body:
- type: textarea
attributes:
label: Summary
label: Résumé
description: |
A clear and concise summary of what the bug is.
Un résumé clair et concis du bug.
placeholder: |
Example bug report:
When I click the "Submit" button on "Feedback", nothing happens.
Exemple de rapport de bug :
Lorsque je clique sur le bouton « Envoyer » des retours, rien ne se passe.
validations:
required: true
- type: input
attributes:
label: Page
description: |
What page(s) did you encounter this bug on?
Sur quelle page avez-vous constaté le bug ?
placeholder: |
https://react.dev/
https://fr.react.dev/
validations:
required: true
- type: textarea
attributes:
label: Details
label: Détails
description: |
Please provide any additional details about the bug.
Veuillez fournir tout détail complémentaire utile sur ce bug.
placeholder: |
Example details:
The "Submit" button is unresponsive. I've tried refreshing the page and using a different browser, but the issue persists.
Exemples de détails :
Le bouton « Envoyer » ne réagit pas. J'ai tenté de rafraîchir la page et d'utiliser un autre navigateur, mais le problème persiste.
validations:
required: false
24 changes: 12 additions & 12 deletions .github/ISSUE_TEMPLATE/1-typo.yml
Original file line number Diff line number Diff line change
@@ -1,34 +1,34 @@
name: "🤦 Typo or mistake"
description: "Report a typo or mistake in the docs."
name: "🤦 Typo ou erreur"
description: "Signale une typo ou une erreur dans les docs."
title: "[Typo]: "
labels: ["type: typos"]
body:
- type: textarea
attributes:
label: Summary
label: Résumé
description: |
A clear and concise summary of what the mistake is.
Un résumé clair et concis du bug.
placeholder: |
Example:
The code example on the "useReducer" page includes an unused variable `nextId`.
Exemple :
L'exemple de code sur la page "useReducer" comporte une variable `nextId` inutilisée.
validations:
required: true
- type: input
attributes:
label: Page
description: |
What page is the typo on?
Sur quelle page avez-vous constaté la typo ?
placeholder: |
https://react.dev/
https://fr.react.dev/
validations:
required: true
- type: textarea
attributes:
label: Details
label: Détails
description: |
Please provide a explanation for why this is a mistake.
Veuillez fournir tout détail complémentaire utile pour comprendre la nature de l'erreur.
placeholder: |
Example mistake:
In the "useReducer" section of the "API Reference" page, the code example under "Writing a reducer function" includes an unused variable `nextId` that should be removed.
Exemple d'erreur :
Dans la section « useReducer » de la page « Référence de l'API », l'exemple de code pour la partie « Écrire la fonction de réduction » comporte une variable `nextId` qui devrait être retirée.
validations:
required: false
22 changes: 11 additions & 11 deletions .github/ISSUE_TEMPLATE/2-suggestion.yml
Original file line number Diff line number Diff line change
@@ -1,34 +1,34 @@
name: "💡 Suggestions"
description: "Suggest a new page, section, or edit for an existing page."
description: "Suggère une nouvelle page, section ou mise à jour d'une page existante."
title: "[Suggestion]: "
labels: ["type: documentation"]
body:
- type: textarea
attributes:
label: Summary
label: Résumé
description: |
A clear and concise summary of what we should add.
Un résumé clair et concis de ce que nous devrions ajouter.
placeholder: |
Example:
Add a new page for how to use React with TypeScript.
Exemple :
Ajouter une page décrivant l'utilisation de React avec TypeScript.
validations:
required: true
- type: input
attributes:
label: Page
description: |
What page is this about?
De quelle page s'agit-il ?
placeholder: |
https://react.dev/
https://fr.react.dev/
validations:
required: false
- type: textarea
attributes:
label: Details
label: Détails
description: |
Please provide a explanation for what you're suggesting.
Veuillez nous expliquer ce que vous suggérez.
placeholder: |
Example:
I think it would be helpful to have a page that explains how to use React with TypeScript. This could include a basic example of a component written in TypeScript, and a link to the TypeScript documentation.
Exemple :
Je pense qu'il serait utile d'avoir une page expliquant comment utiliser React avec TypeScript. Elle pourrait inclure un exemple simple de composant écrit en TypeScript, et faire les liens adéquats vers la documentation de TypeScript.
validations:
required: true
94 changes: 47 additions & 47 deletions .github/ISSUE_TEMPLATE/3-framework.yml
Original file line number Diff line number Diff line change
@@ -1,116 +1,116 @@
name: "📄 Suggest new framework"
description: "I am a framework author applying to be included as a recommended framework."
name: "📄 Suggérer un nouveau framework"
description: "Je suis l'auteur·e d'unframework et j'aimerais qu'il fasse partie des frameworks recommandés."
title: "[Framework]: "
labels: ["type: framework"]
body:
- type: markdown
attributes:
value: |
## Apply to be included as a recommended React framework
## Candidature pour l'inclusion d'un framework React recommandé
_This form is for framework authors to apply to be included as a recommended [React framework](https://react.dev/learn/start-a-new-react-project). If you are not a framework author, please contact the authors before submitting._
Our goal when recommending a framework is to start developers with a React project that solves common problems like code splitting, data fetching, routing, and HTML generation without any extra work later. We believe this will allow users to get started quickly with React, and scale their app to production.
While we understand that many frameworks may want to be featured, this page is not a place to advertise every possible React framework or all frameworks that you can add React to. There are many great frameworks that offer support for React that are not listed in our guides. The frameworks we recommend have invested significantly in the React ecosystem, and collaborated with the React team to be compatible with our [full-stack React architecture vision](https://react.dev/learn/start-a-new-react-project#which-features-make-up-the-react-teams-full-stack-architecture-vision).
To be included, frameworks must meet the following criteria:
- **Free & open-source**: must be open source and free to use.
- **Well maintained**. must be actively maintained, providing bug fixes and improvements.
- **Active community**: must have a sufficiently large and active community to support users.
- **Clear onboarding**: must have clear install steps to install the React version of the framework.
- **Ecosystem compatibility**: must support using the full range of libraries and tools in the React ecosystem.
- **Self-hosting option**: must support an option to self-host applications without losing access to features.
- **Developer experience**. must allow developers to be productive by supporting features like Fast Refresh.
- **User experience**. must provide built-in support for common problems like routing and data-fetching.
- **Compatible with our future vision for React**. React evolves over time, and frameworks that do not align with React’s direction risk isolating their users from the main React ecosystem over time. To be included on this page we must feel confident that the framework is setting its users up for success with React over time.
_Ce formulaire s'adresse aux auteur·es de framework qui souhaitent candidater pour qu'il fasse partie de la liste des [frameworks React](https://react.dev/learn/start-a-new-react-project) recommandés. Si vous n'êtes pas l'auteur·e du framework, contactez ses auteur·es pour leur suggérer de candidater._
Lorsque nous recommandons un framework, nous le faisons afin que les développeur·ses puissent démarrer avec un projet React qui s'occupe d'entrée de jeu de sujets récurrents tels que la découpe de code, le chargement de données, le routage et la génération du HTML, sans avoir à fournir un travail complémentaire. Nous estimons que ça permettra aux gens de démarrer plus vite avec React, et de faire monter leur application à l'échelle en production.
Même si nous comprenons bien que de nombreux frameworks aimeraient être inclus dans la liste, cette page n'est pas là pour faire la publicité de tous les frameworks React potentiels, ou de tous les frameworks auxquels React peut être intégré. Il existe de nombreux superbes frameworks capables d'intégrer React mais que nous ne listons pas dans nos guides. Les frameworks que nous recommandons ont investi de façon significative dans l'écosystème React, et collaboré avec l'équipe React pour être compatible avec notre [vision d'une architecture React full-stack](https://fr.react.dev/learn/start-a-new-react-project#which-features-make-up-the-react-teams-full-stack-architecture-vision).
Please note, we have reviewed most of the popular frameworks available today, so it is unlikely we have not considered your framework already. But if you think we missed something, please complete the application below.
Pour être inclus dans la liste, un framework doit satisfaire les critères suivants :
- **Open-source et gratuit** : il doit être en logiciel libre et son utilisation gratuite.
- **Bonne maintenance** : il doit être activement maintenu, avec correctifs et améliorations.
- **Communauté active** : il doit disposer d'une communauté suffisamment large et vivante pour aider ses utilisateurs.
- **Adoption facile** : il doit disposer d'étapes claires pour l'installation de la version React du framework.
- **Compatible avec l'écosystème** : il doit prendre en charge l'ensemble des bibliothèques et outils de l'écosystème React.
- **Auto-hébergement possible** : il doit permettre l'auto-hébergement d'applications sans que cela en limite les fonctionnalités.
- **Expérience de développement (DX)** : il doit permettre aux développeur·ses d'être productif·ves grâce à des fonctionnalités telles que _Fast Refresh_.
- **Expérience utilisateur (UX)** : il doit fournir des solutions intégrées aux problématiques usuelles telles que le routage et le chargement de données.
- **Compatible avec notre vision de l'avenir de React**. React évolue avec le temps, et les frameworks qui ne s'alignent pas avec la direction que prend React risquent au fil du temps d'isoler leurs utilisateurs de l'écosystème React principal. Pour vous inclure sur cette page, nous devons être confiants dans la capacité du framework à placer ses utilisateurs durablement sur le chemin du succès avec React.
Notez bien que nous avons déjà passé en revue la plupart des frameworks populaires disponibles pour le moment, il est donc peu probable que nous n'ayons pas encore examiné votre framework. Mais si vous pensez que nous avons loupé quelque chose, veuillez remplir le formulaire ci-dessous.
- type: input
attributes:
label: Name
label: Nom
description: |
What is the name of your framework?
Quel est le nom de votre framework ?
validations:
required: true
- type: input
attributes:
label: Homepage
label: Page d'accueil
description: |
What is the URL of your homepage?
Quelle est l'URL de votre page d'accueil ?
validations:
required: true
- type: input
attributes:
label: Install instructions
label: Instructions d'installation
description: |
What is the URL of your getting started guide?
Quelle est l'URL de votre guide de démarrage ?
validations:
required: true
- type: dropdown
attributes:
label: Is your framework open source?
label: Votre framework est-il open source ?
description: |
We only recommend free and open source frameworks.
Nous ne recommandons que les frameworks open source et gratuits.
options:
- 'No'
- 'Yes'
- 'Non'
- 'Oui'
validations:
required: true
- type: textarea
attributes:
label: Well maintained
label: Maintenance active
description: |
Please describe how your framework is actively maintained. Include recent releases, bug fixes, and improvements as examples.
Veuillez décrire (en anglais) en quoi votre framework est activement maintenu. Fournissez des exemples récents de versions publiées, correctifs et améliorations.
validations:
required: true
- type: textarea
attributes:
label: Active community
label: Communauté active
description: |
Please describe your community. Include the size of your community, and links to community resources.
Veuillez décrire (en anglais) votre communauté. Indiquez-en la taille et fournissez des liens sur les ressoures communautaires.
validations:
required: true
- type: textarea
attributes:
label: Clear onboarding
label: Adoption facile
description: |
Please describe how a user can install your framework with React. Include links to any relevant documentation.
Veuillez décrire (en anglais) comment une personne peut installer votre framework avec React. Fournissez les liens adéquats vers votre documentation.
validations:
required: true
- type: textarea
attributes:
label: Ecosystem compatibility
label: Compatibilité avec l'écosystème
description: |
Please describe any limitations your framework has with the React ecosystem. Include any libraries or tools that are not compatible with your framework.
Veuillez décrire (en anglais) toute limite connue que votre framework aurait vis-à-vis de l'écosystème React. Indiquez toute bibliothèque ou tout outil dont vous savez qu'il n'est pas compatible avec votre framework.
validations:
required: true
- type: textarea
attributes:
label: Self-hosting option
label: Auto-hébergement
description: |
Please describe how your framework supports self-hosting. Include any limitations to features when self-hosting. Also include whether you require a server to deploy your framework.
Veuillez décrire (en anglais) en quoi votre framework permet l'auto-hébergement. Indiquez toute limitation connue de fonctionnalités dans le cadre de l'auto-hébergement. Indiquez aussi s'il faut un serveur pour déployer votre framework.
validations:
required: true
- type: textarea
attributes:
label: Developer Experience
label: Expérience de développement (DX)
description: |
Please describe how your framework provides a great developer experience. Include any limitations to React features like React DevTools, Chrome DevTools, and Fast Refresh.
Veuillez décrire (en anglais) en quoi votre framework permet une super expérience de développeemnt. Indiquez toute limite connue aux fonctionnalités telles que les outils de développement React, ceux de Chrome ou encore le Fast Refresh.
validations:
required: true
- type: textarea
attributes:
label: User Experience
label: Expérience utilisateur (UX)
description: |
Please describe how your framework helps developers create high quality user experiences by solving common use-cases. Include specifics for how your framework offers built-in support for code-splitting, routing, HTML generation, and data-fetching in a way that avoids client/server waterfalls by default. Include details on how you offer features such as SSG and SSR.
Veuillez décrire (en anglais) en quoi votre framework aide les gens à créer une expérience utilisateur de grande qualité, en s'occupant directement des problématiques courantes. Indiquez par exemple en quoi vous gérez nativement la découpe de code, le routage, la génération de HTML ou le chargement de données d'une façon qui évite par défaut les cascades de requêtes client/serveur. Détaillez la façon dont vous permettez des approches telles que SSG ou SSR.
validations:
required: true
- type: textarea
attributes:
label: Compatible with our future vision for React
label: Compatible avec notre vision de l'avenir de React
description: |
Please describe how your framework aligns with our future vision for React. Include how your framework will evolve with React over time, and your plans to support future React features like React Server Components.
Veuillez décrire (en anglais) en quoi votre framework est aligné avec notre vision de l'avenir de React. Indiquez comment votre framework évoluera avec React, et quels sont vos plans pour prendre en charge les fonctionnalités à venir de React telles que les React Server Components.
validations:
required: true
10 changes: 5 additions & 5 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
contact_links:
- name: 📃 Bugs in React
- name: 📃 Bugs dans React
url: https://github.com/facebook/react/issues/new/choose
about: This issue tracker is not for bugs in React. Please file React issues here.
- name: 🤔 Questions and Help
url: https://reactjs.org/community/support.html
about: This issue tracker is not for support questions. Please refer to the React community's help and discussion forums.
about: Ce suivi de tickets ne sert pas aux bugs dans React. Déposez vos tickets React plutôt là-bas.
- name: 🤔 Questions et Aide
url: https://react.dev/community
about: Ce suivi de tickets ne sert pas au support technique. Consultez plutôt l'aide communautaire de React et les forums de discussion.
2 changes: 1 addition & 1 deletion src/components/MDX/Sandpack/Preview.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -188,7 +188,7 @@ export function Preview({
? 'absolute opacity-0 pointer-events-none duration-75'
: 'opacity-100 duration-150'
)}
title="Sandbox Preview"
title="Prévisualisation de la sandbox"
style={{
height: iframeComputedHeight || '15px',
zIndex: isExpanded ? 'initial' : -1,
Expand Down
8 changes: 4 additions & 4 deletions src/components/MDX/SandpackWithHTMLOutput.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ export default function ShowRenderedHTML({children}) {
);
return (
<>
<h1>Rendered HTML:</h1>
<h1>HTML produit :</h1>
<pre>
{formatHTML(markup)}
</pre>
Expand All @@ -27,9 +27,9 @@ const formatHTML = `
import format from 'html-format';
export default function formatHTML(markup) {
// Cheap tricks to format the HTML readably -- haven't been able to
// find a package that runs in browser and prettifies the HTML if it
// lacks line-breaks.
// Bidouilles pour formatter lisiblement le HTML -- je n'ai pas
// réussi à trouver un module tournant côté navigateur qui nettoie
// le HTML s'il n'a pas de retours-chariot.
return format(markup
.replace('<html>', '<html>\\n')
.replace('<head>', '<head>\\n')
Expand Down
Loading

0 comments on commit 0ebbac6

Please sign in to comment.