CakePHP Centro da Comunidade c

Suporte ao Usuário¶

Uma das melhores maneiras de contribuir com o CakePHP é apoiar diretamente a comunidade de desenvolvedores. Não precisa ser um gênio ou um guru para se enturmar, talvez você seja o único a ter a resposta a algumas das perguntas que serão feitas. Aqui estão algumas maneiras que você pode começar:

• Join the Slack or Discord server and talk to developers who need help.
• Responda perguntas em plataformas como o StackOverflow.
• Comente em publicações no fórum para solucionar problemas específicos.

Marketing e Evangelismo¶

Como um projeto open-source, apoiado pela Cake Software Foundation, Inc. não temos um orçamento enorme para divulgar o framework, por isso, dependemos de pessoas, como você, se envolverem e apoiarem a comunidade. Há muitas ações que podem ajudar a aumentar a conscientização, compartilhar experiências e educar os seus colegas desenvolvedores sobre os benefícios do CakePHP.

Escreva e Fale Sobre o CakePHP

Falar e escrever sobre o CakePHP ajuda a divulgar o framework.

• Escrever um artigo sobre um determinado recurso ou relatar sua experiência quanto a desenvolvimento.
• Comentar artigos ou mensagens e fornecer ideias e argumentos que possam gerar interação e feedback.
• Use as plataformas sociais, como Facebook, Discourse ou Twitter para fornecer links para artigos, posts, plugins, eventos, etc.

Auxilie sua comunidade local

Dependemos de pessoas que conhecem e compreendem a sua comunidade local. Isso não só se refere à diferença entre idiomas, mas também aos costumes locais e as diferenças culturais. Você pode nos ajudar conectando-se com sua comunidade local e apoiando o CakePHP. Algumas ações que você pode realizar incluem:

• Começar ou ingressar em um grupo de usuários local
• Organizar eventos ou meet-ups
• Compartilhar informação e conhecimento

Contribuindo com Código¶

Se você quer contribuir com código para uma correção de bug, então coordene sua abordagem através dos comentários na issue, vinculando a um gist/pastebin ou referenciando o commit(s) da correção.

Contribuindo através de Pull Requests

Contribuir através de commits num fork do GitHub é a melhor maneira de submeter correções. Se a sua correção é maior do que um único commit, você deve criar um branch nomeado de forma apropriada e relacionada a essa mesma correção. Isso facilita a integração.

Testes e QA¶

Preencher issues é uma forma excelente de ajudar. Ao encontrar e reportar issues, você notifica os desenvolvedores do framework e os ajuda a resolver qualquer tipo de problema. A lista de issues dos projetos relacionados ao CakePHP está armazenada no GitHub

Encontrou um Bug?

Às vezes há problemas no CakePHP. Se você acha que encontrou um, você pode:

• Buscar uma ocorrência similar ou issues existentes,
• Criar uma nova issue se você tem certeza de que não existe um problema semelhante.
• Adicione instruções detalhadas sobre como reproduzir o bug. Isso pode ser na forma de casos de teste ou um trecho de código que demonstra o problema. Não ter uma maneira de reproduzir um problema, significa que é menos provável que seja corrigido.

Issues que precisam de informações adicionais

Novas issues muitas vezes precisam ser confirmadas ou precisam de mais informações. Pedir informações adicionais sobre issues pouco claras não leva muito tempo e ajuda a acelerar o processo.

Confirmar ou invalidar issues existentes que necessitam de alguma forma de reprodução

Se um problema não puder ser facilmente reproduzido ou não estiver claro, ele será marcado como "on hold". Issues marcadas como on hold, geralmente precisam de uma forma de ser confirmadas. Você pode ajudar descobrindo formas de reproduzir problemas ou incentivar autores de submissões a obter mais informações. Questões que estão on hold podem ser encontradas aqui

Problemas de Bugs referentes a releases de manutenção

Versões existentes geralmente têm algumas issues abertas relacionadas a elas. Esses problemas geralmente precisam de patches e casos de teste criados para eles. Preparar patches para issues sem solução é uma ótima maneira de se envolver com o CakePHP, e é um dos primeiros passos para se tornar um contribuinte do núcleo de desenvolvimento.

Recursos e aprimoramentos para lançamentos futuros

Estamos atualmente trabalhando nas versões 4.x releases . Há ainda uma série de tarefas incompletas e defeitos não resolvidos . Se um problema tiver sido movido para um milestone específico, está planejado para ser incluído nessa mesma versão indicada. As issues são movidas para milestones com base no feedback da comunidade e nos planos da equipe de desenvolvimento. Se você planeja contribuir com um feature, inclua também casos de teste relevantes. Queremos manter o CakePHP livre de erros, e os casos de teste provaram ser imensamente úteis. Se você enviar features sem casos de teste e nenhuma documentação é altamente improvável que ele seja aceito.

O CakePHP é continuamente integrado, então você pode checar o status de várias várias compilações no servidor Jenkins a qualquer momento.

Documentação¶

Documentação é outra excelente maneira de começar a se envolver com o CakePHP. Temos duas formas primárias de documentação, a API e o Cookbook. A API é gerada a partir do código-fonte, então se você encontrar uma imprecisão ou problema com a documentação da API, você deve enviar um patch relacionado ao código-fonte. O Cookbook é uma fonte de documentação gerenciada pela comunidade que também pode ser encontrada no GitHub. Orientações sobre contribuições para a documentação podem ser vistas aqui.

Traduções¶

Temos desenvolvedores de muitos países que usam o CakePHP. Traduzir o conteúdo do Cookbook para a sua língua é outra maneira de apoiar a comunidade. Fornecer o material de suporte e documentação oficial em muitos idiomas, torna possível diminuir a barreira de entrada que impede novos desenvolvedores de utilizarem o framework.