Capitalize React concepts in docs
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- JavaScript
- Estrellas
- 11.8k
- Forks
- 7.9k
- Merge medio
- 1 d 11 h
- PR fusionados (30 d)
- 11
Descripción
Summary
We should be capitalizing proper React concepts in the docs. This was flagged by @samselikoff here and I took a first pass at correct Effects, Hooks, and Transitions in https://github.com/reactjs/react.dev/pull/6712.
Remaining items
The remaining items are:
- Components (In progress: https://github.com/reactjs/react.dev/pull/6717)
- State (In progress: https://github.com/reactjs/react.dev/pull/6720)
- Actions
- Context (In progress: https://github.com/reactjs/react.dev/pull/6718)
- Suspense
- Error Boundaries (In Progress: https://github.com/reactjs/react.dev/pull/6719)
- ... more?
Submitting a PR
-
Please do not ask to take an item, just submit a PR. If multiple people submit the same PR, I'll add co-author credit to the commit.
-
Only submit one PR per concept
-
When you submit a PR, please try and cover all usages in all the docs, on all pages excluding the blog and community pages.
-
Avoid fixing one or two instances and favor full coverage to minimize the number of PRs and reviews.
Note that headings like {/* usestate */} must stay lower case, so a find and replace won't work.
Style Guide
- Capitalize React-specific concepts: Capitalize the names of React concepts and features when referring to them specifically.
- Lowercase all others: Use lowercase when these words are used in a general context or referring to their general computing or programming meaning.
Guidelines for Specific Terms
Components
- Capitalize when referring to React Components
- ❌ Incorrect: "functional components are a core concept in React."
- ✅ Correct: "Functional Components are a core concept in React."
- Use lowercase when discussing components in a general programming or descriptive sense
- ❌ Incorrect: "Components should manage their own State."
- ✅ Correct: "components should manage their own state."
State
- Capitalize when discussing React State in the context of the React system
- ❌ Incorrect: "Create dynamic and interactive Components with state."
- ✅ Correct: "Create dynamic and interactive Components with State."
- Use lowercase for the general concept of state
- ❌ Incorrect: "When a component's State changes, it re-renders."
- ✅ Correct: "When a component's state changes, it re-renders."
Effects
- Capitalize when referring to Effects used via hooks like useEffect
- ❌ Incorrect: "Use effects to perform side effects in function components."
- ✅ Correct: "Use Effects to perform side effects in function components."
- Use lowercase for general references to effects or side effects in programming
- ❌ Incorrect: "Effects let you perform side Effects in function components."
- ✅ Correct: "Effects let you perform side effects in Function Components."
Transitions
- Capitalize when discussing the specific Transition feature ("use Transitions to defer updates").
- ❌ Incorrect: "use transitions to defer updates"
- ✅ Correct: "use Transitions to defer updates"
- Use lowercase when referring to the general concept of transitions in UI/UX ("transition animations").
- ❌ Incorrect: You can also add a CSS Transition to delay dimming
- ✅ Correct: You can also add a CSS transition to delay dimming
Context
- Capitalize when discussing the specific Context feature ("use Context to share data").
- ❌ Incorrect: "use context to share data between components"
- ✅ Correct: "use Context to share data between Components"
- Use lowercase when the word "context" refers to the general concept of context (understand the context)
- ❌ Incorrect: "understand the Context it's running in"
- ✅ Correct: "understand the context it's running in"
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Comienza con la guía de estilo del issue y, después, busca en todas las páginas de documentación un concepto restante, como Actions o Suspense, excluyendo las páginas de blog y de la comunidad. Revisa cada uso en su contexto, porque los términos generales de programación y los encabezados como {/* usestate */} permanecen en minúsculas. Se considera terminado cuando un PR cubre todos los usos de ese concepto con la capitalización especificada.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- javascript, react
- Área
- content, documentation
- Tipo de issue
- Documentación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Estado de actividad
- Estancado
- Claridad
- Bastante claro
- Aptitud para principiantes
- 35/100