Esclarecendo os procedimentos e o fluxo de registro de novas propostas de melhorias para o framework Demoiselle. #

Diagrama de Atividades do Fluxo #

Definições #

Definições dos Papéis no fluxo da proposta

Papel da Comunidade

• Qualquer membro da comunidade (registrados ou não), pode apresentar uma nova proposta para o framework Demoiselle.
• Utilizar a ferramenta oficial, e os respectivos modelos (templates)

, para o registro da proposta.

• Prestar os devidos esclarecimentos, quando solicitado.
• Acatar as decisões do núcleo.
• Pedir revisão ou esclarecimentos relativos à nova proposta.

Papel dos Desenvolvedores Dedicados

• Avaliar todas as propostas encaminhadas
• Admitir ou recusar uma proposta
• Pedir esclarecimentos aos proponentes (comunidade).
• Encaminhar para apreciação do DTC (Conselho Técnico) propostas que não estejam no escopo definido no "Road-Map".
• Encaminhar para apreciação do DTC as propostas que trarão significativos e relevantes efeitos inter projetos.
• Fechar Proposta.
• Re-abrir Proposta.
• Definir um responsável do núcleo para acompanhar a proposta.
• Avaliar os resultados.

Papel do Responsável

• Promover e acompanhar a divulgação da proposta
• Abrir e acompanhar o fórum da proposta.
• Avaliar os resultados.
• Submeter ao núcleo os resultados e as avaliações.
• Confirmar/Recusar a proposta.

Papel do Desenvolvedor

• Receber ou atribuir um caso.
• Desenvolver ou adaptar codificação para o caso da proposta
• Concluir o caso.

Papel do DTC - Demoiselle Technical Council (Conselho Técnico Demoiselle)

• Instância superior onde serão resolvidas as mediações, impasses, e casos não previstos.
• Avaliar as propostas que trarão significativos e relevantes efeitos inter projetos.
• Avaliar as propostas que não estejam no escopo definido pelo "Road-Map".
• Zelar pelo bom andamento das propostas e tomar as medidas necessárias.

Papel do DCC - Demoiselle Community Council (Conselho da Comunidade Demoiselle)

• Influenciar nas definições de "Road-Map (Planejamento)"
• Acompanhar as decisões tomadas pelo Conselho Técnico.
• Interagir com o Conselho Técnico.

Definições das Ações no Fluxo da proposta

Apresentar Proposta (Comunidade)

• Inclusão de uma requisição do tipo “New Feature”, na ferramenta Mantis, obedecendo o modelo padrão.

Esclarecer Proposta (Comunidade)

• Prestar informações, também através da ferramenta Mantis, sobre a proposta apresentada. Dirimindo as dúvidas e questionamentos iniciais sobre o formato e conteúdo da proposta.

Admitir Proposta (Desenvolvedores Dedicados)

• A proposta será dada como admitida, após ser analisada pelo grupo dedicado e considerada viável de desenvolvimento, e se necessário, após todos os pedidos de esclarecimentos terem sido efetuados. Este procedimento ainda não garante que a proposta será desenvolvida ou incluída/adaptada ao Demoiselle.

Solicitar Esclarecimentos (Desenvolvedores Dedicados)

• Após a análise inicial da proposta apresentada, ou mesmo de algum outro retorno, o grupo pode fazer pedidos de esclarecimentos ao proponente da comunidade. Será com base no retorno destas informações que a proposta poderá ser admitida ou não.

Definir Responsável (Desenvolvedores Dedicados)

• Quando a proposta é dada como admitida, o grupo escolherá um de seus membros que será responsável para acompanhar a proposta até o final dos seus trabalhos. O critério de escolha será o de capacidade técnica.

Fechar Proposta (Desenvolvedores Dedicados)

• Esta tarefa ocorre nos seguintes casos
• Recusa da proposta na fase inicial.:: Caso a proposta apresentada seja recusada nesta fase, o registro, na ferramenta de tracking de funcionalidades, será atualizado como fechado, e as justificativas serão apresentadas para o proponente da comunidade.: Recusa após a admissão.

Se a proposta foi admitida, mas foi avaliada como inviável pelo responsável, após as atividades de divulgação e fórum, o grupo avalia os resultados e o registro na ferramenta de tracking é fechado. Ao final do processo de desenvolvimento.:: A proposta será fechada quando todos os procedimentos de desenvolvimento e publicação da nova funcionalidade proposta estejam concluídos. O grupo analisará os resultados e o registro na ferramenta de tracking é fechado.

Reabrir Proposta (Desenvolvedores Dedicados)

• Intempestivamente, o grupo dedicado pode reabrir uma proposta, desde que seja devidamente justificado o motivo. Nesta ação, a proposta será reconduzida ao estado de admissão.

Abrir Fórum de discussões (Responsável)

• É a tarefa de abrir um novo tópico de discussão, na ferramenta definida como oficial, com o objetivo de coletar informações junto à todos os interessados na proposta. Estas informações também darão subsidio para a elaboração e refinamento da proposta.

Acompanhar Fórum (Responsável)

• Nesta ação, o responsável atuará como mediador do fórum, coletará as informações pertinentes e atualizará a proposta quando necessário.

Divulgar Proposta (Responsável)

• Tomar todas as ações necessárias para que a proposta seja exposta e discutida por todos os possíveis interessados.

Confirmar Proposta(Responsável)

• Após as atividades de refinamento da proposta, resultado das discussões no fórum e na divulgação. Quando a proposta atingir o nível de maturidade que pode ser considerada como viável de desenvolvimento, o responsável mudará o estado do registro na ferramenta de tracking para confirmada.

Fechar Fórum de discussões(Responsável)

• Se todos os trabalhos foram considerados concluídos, ou a proposta foi fechada por ter sido avaliada como inviável, o fórum de discussões deve ser bloqueado para alterações.

Atribuir Caso (Responsável)

• Após a proposta ter sido confirmada, um ou mais casos estarão abertos na ferramenta de tracking. O responsável deverá atribuir cada caso ao respectivo desenvolvedor.

Iniciar Resolução de um caso (Desenvolvedor)

• Ao ser atribuído de um caso (registro na ferramenta de tracking), o desenvolvedor tem a tarefa de executar o desenvolvimento, registrando as informações necessárias nas ferramentas oficiais do Demoiselle.

Concluir Resolução de um caso (Desenvolvedor)

• Ao término de todas as tarefas de desenvolvimento, deve ser alterado o estado do registro na ferramenta de tracking para o estado Resolvido.

Descrição do fluxo da proposta. #

• O inicio do processo se dá pela apresentação da proposta, por qualquer contribuidor, através da ferramenta Mantis (http://sourceforge.net/apps/mantisbt/demoiselle), devendo a mesma estar de acordo com as instruções modelo padrão de apresentação de nova proposta.
• O grupo denominado Desenvolvedores dedicados, fará uma análise inicial da proposta, podendo ela ser aceita ou não. Se recusada a proposta, o seu caso no Mantis será fechado com as devidas justificativas. Se necessário o núcleo pedirá esclarecimentos sobre a proposta antes do aceite ou recusa, podendo este passo ser repetido quantas vezes isso for necessário. Se a proposta for aceita passará a ser considerada como aceita, o grupo de desenvolvedores dedicados indicará um membro para o acompanhamento da nova proposta.
• O proponente poderá, intempestivamente, pedir a revisão de proposta negada.
• Os desenvolvedores dedicados devem avaliar se a proposta deve ser encaminhada para análise do Conselho Técnico (DTC), especialmente se não estiver contemplada no Planejamento (Road-Map), ou impacta fortemente em muitos projetos, ou pode gerar uma versão Maior (Convenção desenvolvedor/Convenção nomes/Versionamento).
• Caso a proposta seja encaminhada ao DTC, este avaliará se a proposta será implementada ou não.
• Na seqüência, o responsável indicado pelos desenvolvedores dedicados, fará a abertura de uma discussão em fórum específico para a proposta, relacionando a mesma com o número do caso no Mantis. Concomitantemente, será aberto um processo de divulgação da proposta para a comunidade em geral. O responsável fará o acompanhamento das atividades, como promotor de divulgação e mediador no fórum. Quando necessário, o responsável poderá submeter ao núcleo os resultados dos trabalhos. O resultado final desta fase, será a proposta oficialmente aceita e com o escopo de solução devidamente esclarecido. Cabe então ao responsável avaliar se será necessário a abertura de casos de melhorias, e atribuir cada um deles a um desenvolvedor. Caso os resultados dos trabalhos indiquem que a proposta está inviável de ser implementada no contexto apresentado, o responsável proporá o fechamento da proposta.
• Se aprovada a proposta e com os casos atribuídos, todos os indicados formarão um grupo de trabalho liderado pelo responsável pela proposta. Os trabalhos serão executados de acordo com metodologia de desenvolvimento SCRUM. Ao final desta fase os casos deverão estar com o estado resolvido.
• No passo seguinte, o responsável fará o fechamento(bloqueio) do fórum de discussões.
• O passo final consiste na avaliação dos resultados e a publicação do código pelo grupo de desenvolvedores dedicados. Todos os casos relacionados com a proposta, cadastrados no Mantis, deverão ser fechados.
• O grupo de desenvolvedores dedicados poderá, com as devidas justificativas, reabrir qualquer proposta já apresentada.

Termos #

Comunidade: Qualquer interessado no projeto, que pode ou não estar vinculado ao projeto Demoiselle.

Desenvolvedores Dedicados: Membros de dedicação exclusiva ao projeto Demoiselle com prerrogativas de decisão sobre a aceitação de uma proposta do ponto de vista técnico.

Responsável: Membro do núcleo do Demoiselle indicado e encarregado de acompanhar oficialmente uma proposta em todas fases a partir do aceite da proposta e sua indicação.

Desenvolvedor: Membro da comunidade Demoiselle com atribuições de codificação e com a permissão para tratar um caso (registro na ferramenta de trakking) relatado, efetivando alterações em código-fonte.

DTC (Demoiselle Technical Council): Conselho Técnico Demoiselle, definido conforme modelo de governança e seu estatuto. Conselho da Comunidade

DCC (Demoiselle Community Council): Conselho da Comunidade Demoiselle, definido conforme modelo de governança e seu estatuto. Conselho da Comunidade

Considerações Finais #

O tratamento aqui descrito contempla o fluxo principal de trabalho para tratamento de uma proposta de inclusão ou exclusão de funcionalidade ou componente no projeto Demoiselle, contemplando as situações consideradas como previsíveis no processo. No surgimento de excepcionalidades, a equipe responsável deverá discutir e definir seu tratamento, incrementando este documento com as novas definições. É responsabilidade do DTC (Demoiselle Technical Council) Conselho Técnico Demoiselle, mediar decisões que não foram resolvidas em nível de projeto, sendo esta a instância na qual serão decididas as questões que não foram contempladas no fluxo natural ou onde pode haver dúvidas ou recursos.

Diagrama de Estados do Fluxo #