Configuración de proyectos de GitHub

Comprender el ámbito y la propiedad del proyecto es fundamental para la colaboración correcta entre GitHub Projects y Azure Boards. En esta unidad, exploraremos las consideraciones clave para definir los límites y las responsabilidades del proyecto.

Decisiones de ámbito y propiedad del proyecto

Organización frente a proyectos de usuario: matriz de decisión:

Factor	Proyecto de organización	Proyecto de usuario
Colaboración en equipo	Trabajo de varios equipos, multifuncional	Experimentos individuales o pequeños de equipo
Gobernanza	Procesos de aprobación formales, seguimientos de auditoría	Iteración ligera y rápida
Visibilidad	Transparencia para toda la empresa	Visibilidad personal o limitada
Control de acceso	Permisos basados en roles, Single Sign-On empresarial	Control individual
Ciclo de vida	Cargas de trabajo de producción a largo plazo	Prototipos, aprendizaje, pruebas

Recomendaciones de procedimientos recomendados:

• Uso de proyectos de organización para aplicaciones de producción y servicios compartidos
• Aprovechar los proyectos de usuario para la prueba de conceptos y el aprendizaje individual
• Tenga en cuenta los requisitos de cumplimiento y gobernanza de datos al elegir el ámbito

Flujo de trabajo de creación de proyectos

Para proyectos de organización:

1. Vaya a la página principal de la organización en GitHub.
2. Haga clic en Proyectos en la navegación de la organización.
3. Seleccione la lista desplegable Nuevo proyecto → Nuevo proyecto
4. Elección de una plantilla de proyecto adecuada en función de las necesidades de flujo de trabajo

Para proyectos de usuario:

1. Haga clic en el avatar → Sus proyectos
2. Seleccione la lista desplegable Nuevo proyecto → Nuevo proyecto
3. Selección de una plantilla que se alinea con los objetivos del proyecto

Guía de selección de plantillas de proyecto:

Template	Caso de uso	Características clave
Trabajo pendiente de equipo	Planeamiento de sprints, desarrollo de características	Puntos de historia, ciclos de sprint
Feature	Plan de desarrollo del producto, planeamiento de versiones	Hitos, dependencias
Evaluación de errores	Administración de problemas, control de calidad	Gravedad, prioridad, seguimiento de estado
Blank	Flujos de trabajo personalizados, procesos especializados	Flexibilidad de personalización completa

Documentación del proyecto y estrategia de comunicación

Mejores prácticas de README y descripción:

1. Navegue a su proyecto
2. Haga clic en el menú de configuración (tres puntos) en la parte superior derecha.
3. Seleccione Configuración.
4. Cree documentación completa del proyecto:

Marco de descripción del proyecto:

• Propósito: Declaración clara de los objetivos y el ámbito del proyecto
• Partes interesadas: miembros clave del equipo, patrocinadores y responsables de la toma de decisiones
• Criterios de éxito: resultados medibles y criterios de aceptación
• Escala de tiempo: hitos clave y expectativas de entrega

Estructura del contenido README:

# Project Name

## Overview

Brief description of project goals and context

## Getting Started

Prerequisites and setup instructions

## Workflow Guidelines

- Issue creation and labeling standards
- Review and approval processes
- Communication protocols

## Team Information

Contact details and responsibilities

Plantilla README de muestra:

# Customer Portal Enhancement Project

## Project Overview

Modernize customer self-service portal to improve user experience and reduce support ticket volume by 30%.

## Key Stakeholders

- **Product Owner**: Name (email@company.com)
- **Tech Lead**: Name (email@company.com)
- **UX Designer**: Name (email@company.com)

## Success Metrics

- Page load time < 2 seconds
- User satisfaction score > 4.2/5
- Support ticket reduction of 30%

## Workflow Standards

- All features require design review before development
- Security review mandatory for user-facing changes
- Performance testing required for all releases

Planificación y administración de elementos de trabajo estratégicos

Estrategia de creación y organización de problemas

Flujo de trabajo de configuración inicial del proyecto: Cuando se inicialice el nuevo proyecto, se le pedirá que agregue elementos. Esta es su oportunidad de establecer la base del proyecto.

Enfoque estratégico de creación de problemas:

1. Comience con epopeyas y temas: cree elementos de trabajo de alto nivel que representen las principales características o iniciativas
2. Dividir en historias de usuario: definir funcionalidad específica y verificable desde la perspectiva del usuario
3. Agregar tareas técnicas: incluir trabajo de infraestructura, pruebas e implementación
4. Dependencias del plan: Identifica relaciones de bloqueo y elementos de la ruta crítica

Procedimientos recomendados de plantilla de problemas:

Plantilla de problemas con funciones:

## User Story

As a [user type], I want [functionality] so that [business value].

## Acceptance Criteria

- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

## Definition of Done

- [ ] Code review completed
- [ ] Unit tests written and passing
- [ ] Integration tests updated
- [ ] Documentation updated
- [ ] Accessibility review completed

## Dependencies

- Links to related issues or external dependencies

## Technical Notes

Implementation considerations and architectural decisions

Haga clic en el signo más (+) para agregar más problemas sistemáticamente en función del plan del proyecto.

Jerarquía y organización de elementos de trabajo:

• Epopeyas: principales características o iniciativas
• Características: Funcionalidad entregable
• Historias de usuario: capacidades específicas orientadas al usuario
• Tareas: trabajo de implementación técnica
• Errores: defectos y problemas que requieren resolución

Ejemplos avanzados de categorización de problemas

Estrategia de etiquetado para proyectos empresariales:

Categoría	Etiquetas	propósito
Prioridad	priority:critical, priority:high, , priority:medium, priority:low	Asignación y programación de recursos
Tipo	type:feature, type:bug, , type:technical-debt, type:research	Categorización e informes del trabajo
Team	team:frontend, team:backend, , team:qa, team:design	Propiedad y responsabilidad
Estado	status:blocked, , status:in-review, status:needs-info	Administración del estado del flujo de trabajo
Lanzamiento	release:v2.1, milestone:q1-2024	Planificación y seguimiento de lanzamientos

Configuración y gobernanza avanzadas del proyecto

Administración de seguridad y acceso

Vaya a la configuración del proyecto haciendo clic en el menú (tres puntos) en la esquina superior derecha.

Procedimientos recomendados de control de acceso:

Función	Permisos	Casos de uso
Administrador	Control total del proyecto, administración de configuración	Propietarios de proyectos, líderes tecnológicos
Escribir	Crear o editar elementos, administrar flujos de trabajo	Miembros del equipo de desarrollo
Leer	Ver contenido del proyecto, agregar comentarios	Partes interesadas, equipo de control de calidad
Sin acceso	No se puede ver el proyecto	Usuarios externos, datos restringidos

Consideraciones de seguridad empresarial:

• Habilitación de la autenticación en dos fases para todos los administradores de proyectos
• Revisiones de acceso periódicas y auditorías de permisos (recomendado trimestralmente)
• Integración con sistemas de administración de identidades y SSO empresarial
• Registro de actividades de auditoría para el monitoreo de conformidad y seguridad

Campos personalizados y configuración de flujo de trabajo

Diseño de campo personalizado estratégico:

Seguimiento de valores empresariales:

• Estimación del esfuerzo: puntos de historia o estimaciones de tiempo
• Prioridad empresarial: impacto del cliente o potencial de ingresos
• Evaluación de riesgos: complejidad técnica o riesgo de dependencia
• Requisitos de cumplimiento: seguridad, accesibilidad, necesidades normativas

Ejemplos comunes de campos personalizados de empresa:

Nombre de campo	Tipo	Valores y opciones	propósito
Valor empresarial	Seleccionar	Alto, Medio, Bajo	Priorización y análisis de ROI
Esfuerzo	Number	1-13 (secuencia de Fibonacci)	Planificación y capacidad de Sprint
Componente	Seleccionar	Front-end, back-end, base de datos, API	Propiedad técnica y experiencia
Segmento de cliente	Seleccionar	Empresa, PYME, Individual	Segmentación y validación de características
Destino de lanzamiento	Fecha	Fechas específicas	Planeamiento de hitos y dependencias

Automatización y optimización del flujo de trabajo:

• Configurar transiciones automatizadas de estado basadas en los estados de los pull requests
• Configuración de notificaciones para actualizaciones y bloqueadores críticos
• Establecimiento de ciclos de revisión y flujos de trabajo de aprobación
• Implementar procedimientos de escalación para elementos de trabajo detenidos

Mejora y análisis continuos

Supervisión del estado del proyecto:

• Seguimiento de las tendencias de velocidad y el uso de la capacidad del equipo
• Supervisión del tiempo de ciclo desde la creación del problema hasta la finalización
• Identificación de cuellos de botella y oportunidades de mejora de procesos
• Retrospectivas periódicas y ajustes de flujo de trabajo

Puntos de control de integración:

• Reuniones semanales de sincronización de proyectos con actualizaciones de partes interesadas
• Sesiones mensuales de revisión y optimización de procesos
• Alineación estratégica trimestral y evaluación de objetivos
• Auditorías de seguridad y gobernanza de proyectos anuales

Para obtener más información sobre proyectos, vea:

• Inicio rápido para proyectos: Documentos de GitHub.
• Creación de un problema: GitHub Docs.