paint-brush
La ventaja de una página: una plantilla para proyectos de ingeniería de softwarepor@vlshahane
2,750 lecturas
2,750 lecturas

La ventaja de una página: una plantilla para proyectos de ingeniería de software

por Vishal Shahane
Vishal Shahane HackerNoon profile picture

Vishal Shahane

@vlshahane

Vishal is a Senior Software at AWS for over a...

3 min read2024/05/22
Read on Terminal Reader
Read this story in a terminal
Print this story
Read this story w/o Javascript
Read this story w/o Javascript

Demasiado Largo; Para Leer

La complejidad de los sistemas de software a menudo requiere que los ingenieros o gerentes de software escriban propuestas para alinear al equipo, la organización o las partes interesadas. Estas propuestas ayudan a comunicar motivaciones, recomendaciones o hitos de manera concisa, al mismo tiempo que obtienen retroalimentación y alinean a todas las partes interesadas. Este artículo proporciona una plantilla genérica para escribir paginadores, aunque no se limita a sistemas de software, ha demostrado ser útil para liderar organizaciones de ingeniería de software.

Companies Mentioned

Mention Thumbnail
Make
Mention Thumbnail
reflect
featured image - La ventaja de una página: una plantilla para proyectos de ingeniería de software
Vishal Shahane HackerNoon profile picture
Vishal Shahane

Vishal Shahane

@vlshahane

Vishal is a Senior Software at AWS for over a decade with over 16 years of industry experience.

Descargo de responsabilidad : Los puntos de vista y opiniones expresados en este artículo son exclusivamente míos y no reflejan necesariamente los puntos de vista de ninguna institución u organización.

Introducción

La complejidad de los sistemas de software a menudo requiere que los ingenieros o gerentes de software escriban propuestas para alinear equipos, organizaciones o partes interesadas (equipos de socios, servicios dependientes, etc.) en los cambios. Estas propuestas ayudan a comunicar motivaciones, recomendaciones o hitos de manera concisa, al mismo tiempo que obtienen comentarios y alinean a todas las partes interesadas.


Dichos documentos también sirven como puntos de referencia pasados para los nuevos empleados que se apropian de los sistemas de software y comprenden el proceso de pensamiento de cómo se tomaron las decisiones en el pasado. Este artículo proporciona una plantilla genérica para escribir un buscapersonas; Aunque no se limita a los sistemas de software, se ha demostrado que es útil para liderar organizaciones de ingeniería de software.

Plantilla

Descripción general

Este será el resumen ejecutivo del documento, bueno para captar la motivación y lo que estás proponiendo para que los lectores se interesen en tu documento.

Introducción

Proporcione detalles sobre los antecedentes/motivación del cambio. Se pueden incluir métricas/datos para explicar el problema y proporcionar información adicional.

Objetivos

Requisitos dentro del alcance para este proyecto.

No metas

Mencione cualquier tarea que no sea un objetivo o que esté fuera del alcance de este proyecto. Estas pueden ser distracciones para resolver el problema en el que desea concentrarse.

Opciones

Resuma una lista de opciones/alternativas que consideró para resolver el problema, preferiblemente con los pros y los contras de cada una.

Recomendación

Con base en las alternativas discutidas en la sección anterior, brinde recomendaciones para soluciones estratégicas con explicaciones o argumentos de respaldo.


Enfoque táctico como opción: según los desafíos/el cronograma asociados con el logro del enfoque recomendado, considere brindar una solución táctica; Potencialmente, esto puede ser un paso incremental hacia una solución estratégica o un cambio mínimo para abordar el problema en el corto plazo.

Pruebas

Describa cómo validará que la función esté funcionando según lo previsto; ¿Para qué probarás? ¿Cómo lo probarás? ¿Habrá un período de validación gamma o de preproducción? ¿Qué implicará eso? Asegúrese de incluir casos de prueba que verifiquen que la función solo se aplica a los eventos en los que debería aplicarse.

Hitos

Enumere las tareas/hitos de alto nivel para las soluciones recomendadas con estimaciones en días de desarrollo. Para proporcionar esta lista además de los cambios funcionales, piense en:

  • Estrategia de pruebas antes del lanzamiento (pruebas unitarias, de integración, etc.)
  • Necesidad/estrategia de reposición
  • Cualquier cambio en las métricas/scripts de informes/herramientas
  • Nuevas métricas/pasos de validación después del lanzamiento (canarios, flujos de trabajo de aprobación de canalizaciones)
  • Revisión de seguridad
  • Mini revisión de la preparación operativa

Referencias

Referencias que cree que podrían ayudar a los lectores a profundizar en el espacio del problema o en las alternativas presentadas.

Preguntas frecuentes

Responder de manera proactiva cualquier pregunta o pregunta anticipada que pueda haber surgido en discusiones consecutivas relacionadas con esta propuesta.

Apéndice

Agregue cualquier información complementaria a la propuesta, a la que los lectores puedan consultar según sea necesario.

Notas de la reunión

Mantenga el siguiente resumen para las reuniones en las que tenga la revisión de la propuesta.

Asistentes

Listado de personas que asistieron a la reunión.

MoM (Acta de Reunión)

Resuma el acta de la reunión para referencia futura.

L O A D I N G
. . . comments & more!

About Author

Vishal Shahane HackerNoon profile picture
Vishal Shahane@vlshahane
Vishal is a Senior Software at AWS for over a decade with over 16 years of industry experience.

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN...

Permanent on Arweave
Read on Terminal Reader
Read this story in a terminal
 Terminal
Read this story w/o Javascript
Read this story w/o Javascript
 Lite

MENCIONADOS EN ESTA HISTORIA

companies
X REMOVE AD