Acerca de los elementos obsoletos
El término "obsoleto" se aplica a funcionalidades o componentes que están en proceso de ser reemplazados por otros más nuevos o que se eliminarán por completo.
Ejemplo: puede ser algo tan pequeño como una propiedad individual de un componente (cambio de nombre de label a newlabel), pero también se puede aplicar a todo un componente o funcionalidad.
La funcionalidad puede quedar obsoleta porque:
- Será reemplazada por una nueva funcionalidad.
- Es posible que la funcionalidad no se alinee con la visión/hoja de ruta a largo plazo de Jutro.
¿Obsoleto significa que algo ya no funcionará?
No.
El hecho de quedar obsoleto significa que toda la funcionalidad actual funciona sin cambios y que puede seguir usándola sin ninguna modificación de código, pero no recibirá nuevas actualizaciones de características. Además, cuando utilice un componente o una función obsoletos, verá un mensaje de advertencia en el modo desarrollo.
¿Cómo sé que algo ha quedado obsoleto?
Esta información se incluye en lo siguiente:
- Las notas de la versión incluyen qué funcionalidades han quedado obsoletas.
- El esquema IDE o las sugerencias automáticas informan lo que ha quedado obsoleto.
- Advertencias de consola.
- El código en sí mismo.
- La documentación de Storybook incluye las propiedades de los componentes que han quedado obsoletas.
- Storybook muestra el rótulo “Deprecated” (Obsoleto) junto a los componentes que han quedado obsoletos.
¿Qué hago cuando algo queda obsoleto?
No se requiere ninguna acción inmediata.
Cuando un elemento obsoleto afecte a una aplicación, puede decidir cuándo proceder con la alternativa sugerida, pero todo seguirá funcionando; por eso, esto se puede planificar y ejecutar en una etapa posterior. Se recomienda convertir las aplicaciones a la nueva alternativa lo antes posible para beneficiarse de las nuevas características y respetar las prácticas recomendadas y las últimas versiones.
Cuando algo queda obsoleto, se pueden ofrecer diferentes alternativas:
-
Existe un nuevo componente o función. La alternativa en esta situación sería usar la nueva característica para reemplazar la obsoleta. En algunos casos, la migración se puede facilitar a través de algunas automatizaciones proporcionadas (también conocidas como codemods).
-
Reemplazo por un patrón. En el caso de los componentes, la alternativa podría ser el uso de un patrón proporcionado y su personalización para cumplir con los requisitos específicos del proyecto.
-
No se ofrece otra alternativa. En algunas situaciones, quizás se decida que no es necesaria otra alternativa. Esto puede suceder porque esa funcionalidad se considera obsoleta o fuera del ámbito de las responsabilidades de la biblioteca. En este caso, si aún es necesaria, los consumidores pueden decidir si prefieren implementarla como parte de su proyecto o pedirle al equipo de Guidewire que les proporcione el código actual para ellas.
¿Cuál es el cronograma de asistencia técnica/eliminación para la funcionalidad obsoleta?
- Las obsolescencias pueden ocurrir en cualquier versión principal o de menor importancia.
- La funcionalidad solo puede quedar obsoleta si se cuenta con una funcionalidad u orientación alternativa (a menos que no se considere ninguna alternativa).
- Solo se analizará la posibilidad de retirar por completo la funcionalidad obsoleta cuando no se la utilice o haya planes para eliminarla.
- El retiro final se producirá en una versión importante.
¿Qué significa “asistencia técnica” para una funcionalidad obsoleta?
Cuando una funcionalidad obsoleta se encuentre dentro del período de asistencia, el equipo de Jutro brindará asistencia técnica, reparará el componente si fuera necesario y lo publicará como parte de la próxima versión de menor importancia.