Configurar projetos do GitHub

Entender o escopo e a propriedade do projeto é crucial para a colaboração bem-sucedida entre o GitHub Projects e o Azure Boards. Nesta unidade, exploraremos as principais considerações para definir limites e responsabilidades do projeto.

Decisões de escopo e propriedade do projeto

Organização vs. Projetos de Usuário – Matriz de Decisão:

Fator	Projeto de organização	Projeto de Usuário
Colaboração em equipe	Trabalho multiequipe e multifuncional	Experimentos de equipe individuais ou pequenos
Governança	Processos formais de aprovação, trilhas de auditoria	Iteração leve e rápida
Visibilidade	Transparência em toda a empresa	Visibilidade pessoal ou limitada
Controle de acesso	Permissões baseadas em função, SSO corporativo	Controle individual
Ciclo de vida	Cargas de trabalho de produção de longo prazo	Protótipos, aprendizado, teste

Recomendações de práticas recomendadas:

• Usar projetos de organização para aplicativos de produção e serviços compartilhados
• Aproveitar projetos de usuário para prova de conceitos e aprendizado individual
• Considere os requisitos de conformidade e governança de dados ao escolher o escopo

Fluxo de trabalho de criação de projeto

Para projetos de organização:

1. Navegue até a página principal da sua organização no GitHub
2. Clique em Projetos na navegação da organização
3. Selecionar Novo projeto no menu suspenso → Novo projeto
4. Escolha o modelo de projeto apropriado com base nas necessidades de fluxo de trabalho

Para projetos de usuário:

1. Clique em seu avatar → Seus projetos
2. Selecionar Novo projeto no menu suspenso → Novo projeto
3. Selecione o modelo que se alinha às metas do projeto

Guia de seleção do modelo de projeto:

Template	Caso de uso	Principais recursos
Pendências da equipe	Planejamento de sprint, desenvolvimento de funcionalidades	Pontos de história, ciclos de sprint
Característica	Roteiro do produto, planejamento de versão	Etapas, dependências
Triagem de bugs	Gerenciamento de problemas, garantia de qualidade	Severidade, prioridade, acompanhamento de status
Em branco	Fluxos de trabalho personalizados, processos especializados	Flexibilidade de personalização completa

Documentação do projeto e estratégia de comunicação

Práticas recomendadas de README e descrição:

1. Navegue até seu projeto
2. Clique no menu de configurações (três pontos) no canto superior direito
3. Selecionar Configurações
4. Crie uma documentação abrangente do projeto:

Estrutura de Descrição do Projeto:

• Finalidade: instrução clara dos objetivos e do escopo do projeto.
• Stakeholders: Principais membros da equipe, patrocinadores e tomadores de decisão
• Critérios de sucesso: resultados mensuráveis e critérios de aceitação
• Linha do tempo: Principais marcos e expectativas de entrega

Estrutura de conteúdo 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

Exemplo de modelo README da empresa:

# 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

Planejamento e gerenciamento de item de trabalho estratégico

Criação de problemas e estratégia de organização

Fluxo de trabalho inicial de instalação do projeto: Quando seu novo projeto é inicializado, ele solicita que você adicione itens. Essa é a sua oportunidade de estabelecer a base do projeto.

Abordagem de criação de problemas estratégicos:

1. Comece com épicos e temas: criar itens de trabalho de alto nível que representam recursos ou iniciativas importantes
2. Dividir em histórias de usuário: Definir funcionalidade específica e testável da perspectiva do usuário
3. Adicionar tarefas técnicas: incluir infraestrutura, teste e trabalho de implantação
4. Planejar dependências: identificar relações de bloqueio e itens de caminho críticos

Melhores práticas do modelo de problema:

Modelo de Questão de Funcionalidade:

## 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

Clique no sinal de adição (+) para adicionar mais problemas sistematicamente com base emo seu plano de projeto.

Hierarquia e organização do item de trabalho:

• Epics: Principais recursos ou iniciativas
• Recursos: funcionalidade de entrega
• Histórias de Usuário: recursos específicos voltados para o usuário
• Tarefas: Trabalho de implementação técnica
• Bugs: defeitos e problemas que exigem resolução

Exemplos avançados de categorização de problemas

Estratégia de rotulagem para projetos empresariais:

Categoria	Rótulos	Purpose
Prioridade	priority:critical, priority:high, , priority:mediumpriority:low	Alocação e agendamento de recursos
Tipo	type:feature, type:bug, , type:technical-debttype:research	Categorização e relatórios de trabalho
Equipe	team:frontend, team:backend, , team:qateam:design	Propriedade e responsabilidade
Status	status:blocked, status:in-review, status:needs-info	Gerenciamento de estado do fluxo de trabalho
Lançamento	release:v2.1, milestone:q1-2024	Planejamento e acompanhamento de lançamento

Configuração e governança avançadas do projeto

Gerenciamento de segurança e acesso

Navegue até as configurações do projeto clicando no menu (três pontos) no canto superior direito.

Práticas recomendadas de controle de acesso:

Função	Permissões	Casos de uso
Administrador	Controle de projeto completo, gerenciamento de configurações	Proprietários de projetos, líderes técnicos
Escrever	Criar/editar itens, gerenciar fluxos de trabalho	Membros da equipe de desenvolvimento
Leia	Exibir conteúdo do projeto, adicionar comentários	Partes interessadas, equipe de garantia de qualidade
Sem acesso	Não é possível exibir o projeto	Usuários externos, dados restritos

Considerações de segurança da empresa:

• Habilitar a autenticação de dois fatores para todos os administradores de projeto
• Revisões de acesso regular e auditorias de permissão (trimestralmente recomendado)
• Integração com sistemas corporativos de SSO e gerenciamento de identidade
• Registro de auditoria para monitoramento de segurança e conformidade

Configuração de fluxo de trabalho e campos personalizados

Design de campo personalizado estratégico:

Acompanhamento de valor empresarial:

• Estimativa de esforço: pontos de estória ou estimativas de tempo
• Prioridade comercial: impacto do cliente ou potencial de receita
• Avaliação de risco: complexidade técnica ou risco de dependência
• Requisitos de conformidade: segurança, acessibilidade, necessidades regulatórias

Exemplos comuns de campos personalizados da empresa:

Nome de campo	Tipo	Valores/Opções	Purpose
Valor comercial	Selecionar	Alto, Médio, Baixo	Priorização e análise de ROI
Esforço	Número	1 a 13 (sequência fibonacci)	Planejamento e capacidade de sprint
Componente	Selecionar	Front-end, Back-end, Banco de Dados, API	Propriedade técnica e experiência
Segmento de cliente	Selecionar	Empresa, PME, Indivíduo	Direcionamento e validação de funcionalidades
Destino do lançamento	Date	Datas específicas	Marco e planejamento de dependência

Automação e otimização de fluxo de trabalho:

• Configurar transições de status automatizadas baseadas nos estados do pull request
• Configurar notificações para atualizações críticas e bloqueadores
• Estabelecer ciclos de revisão e fluxos de trabalho de aprovação
• Implementar procedimentos de escalonamento para itens de trabalho paralisados

Melhoria e análise contínuas

Monitoramento de integridade do projeto:

• Acompanhar tendências de velocidade e utilização da capacidade da equipe
• Monitorar o tempo de ciclo desde a criação da tarefa até a conclusão
• Identificar gargalos e oportunidades de melhoria de processo
• Retrospectivas regulares e ajustes de fluxo de trabalho

Pontos de verificação de integração:

• Reuniões semanais de alinhamento de projetos com atualizações das partes interessadas
• Sessões mensais de revisão e otimização do processo
• Alinhamento estratégico trimestral e avaliação de metas
• Auditorias anuais de governança e segurança do projeto

Para obter mais informações sobre projetos, consulte:

• Início Rápido para projetos – GitHub Docs.
• Como criar uma edição - GitHub Docs.