Guia de contribuição do kit de ferramentas FinOps

Bem-vindo ao kit de ferramentas FinOps. Como uma iniciativa de código aberto, nosso sucesso depende do esforço coletivo da comunidade. As suas contribuições desempenham um papel vital na melhoria e expansão das capacidades do conjunto de ferramentas, tornando-o mais valioso e eficaz para todos.

Existem várias formas de contribuir para o conjunto de ferramentas FinOps:

• Trabalhe em bugs existentes: Você pode ajudar identificando e resolvendo bugs existentes listados em nosso repositório.
• Forneça sugestões para novos recursos ou melhorias: Se você não estiver confortável com a codificação, ainda poderá contribuir sugerindo novos recursos ou melhorias para nossas ferramentas.
• Proponha uma nova ferramenta: Se você desenvolveu uma ferramenta relacionada ao FinOps e deseja que ela faça parte do kit de ferramentas do FinOps, você pode enviar uma proposta para consideração.
• Solicitações de pull de revisão: as revisões de código são um aspeto crítico para manter a qualidade do código e garantir a confiabilidade e a funcionalidade do projeto. Ao analisar as solicitações pull (PRs) existentes sugeridas pelos membros da comunidade, você pode contribuir significativamente para o sucesso do projeto sem necessariamente criar um novo código.
• Responder a perguntas: Estar ativamente envolvido na resposta a perguntas e prestar assistência aos membros da comunidade é uma contribuição inestimável para o projeto.
• Atualizar documentação: A documentação serve como um recurso crucial para usuários, desenvolvedores e colaboradores. Esforçamo-nos para manter a documentação precisa, abrangente e atualizada. É essencial para o sucesso do conjunto de ferramentas.

Agradecemos o seu interesse em contribuir para o kit de ferramentas FinOps!

Quer manter-se ligado à equipa? Junte-se à nossa sincronização semanal de colaboradores às quartas-feiras às 8h do horário do Pacífico / 16h UTC ou horário quinzenal de atendimento às 8:30 da manhã do Pacífico / 16:30 UTC.

Trabalhar em erros existentes

Se você está ansioso para contribuir, mas não sabe por onde começar, um ótimo ponto de partida é rever a lista de comentários existentes. Em seguida, identifique problemas que se alinhem com suas habilidades e interesses.

1. Consulte a lista de problemas existentes.
2. Atribua-se ao bug em que deseja trabalhar.

Se está a ler este artigo pela primeira vez e a trabalhar no repositório do toolkit FinOps, certifique-se de rever o nosso wiki de Introdução.

Formas de contribuir

O projeto do kit de ferramentas FinOps oferece várias maneiras de contribuir, seja você um desenvolvedor, um profissional de FinOps ou um entusiasta da nuvem. As secções seguintes abordam formas de participação.

Submeter um novo problema

Se você tiver uma nova sugestão de recurso, identificado um bug ou tiver ideias para melhorar as ferramentas existentes, recomendamos que envie um problema. Os seus comentários ajudam-nos a garantir que o conjunto de ferramentas satisfaz as necessidades dos seus utilizadores. E se estiver disposto a ir mais longe e contribuir para a implementação das suas sugestões, agradecemos as suas contribuições.

Para tal, siga estes passos:

1. Vá para a lista de problemas e selecione Novo problema.
2. Escolha a opção que melhor descreve sua contribuição (correção de bug, solicitação de alteração ou solicitação de recurso).
3. Selecione Disposto a corrigir na parte inferior da página.
4. Envie o seu problema.

Propor uma nova ferramenta

Se você desenvolveu uma ferramenta relacionada ao FinOps e deseja que ela faça parte do kit de ferramentas do FinOps, vá para a lista de problemas, selecione Novo problema e selecione a opção Propor uma nova ferramenta . Inclua o máximo de informações possível sobre sua ferramenta e como ela pode beneficiar a comunidade FinOps.

O conselho diretivo do conjunto de ferramentas FinOps analisa a sua proposta e contacta-o para uma discussão mais aprofundada.

Rever pedidos de pull

Verifique a lista de solicitações pull abertas e forneça feedback construtivo sobre as alterações de código propostas pelos membros da comunidade. Certifique-se de que o código está de acordo com nossas diretrizes de codificação, está bem documentado e segue as práticas recomendadas.

Ofereça sugestões para melhorar a qualidade do código, como otimizar o desempenho, melhorar a legibilidade e abordar possíveis casos de borda ou bugs.

Para garantir que funcionam como pretendido, teste a funcionalidade das alterações de código propostas no PR. Envolve a execução de testes, a verificação de casos extremos e a verificação de quaisquer efeitos secundários não intencionais.

Quando possível, tente sugerir alterações de código usando Adicionar uma sugestão para simplificar o processo de revisão.

Responder a perguntas

Estar ativamente envolvido na resposta a perguntas e na prestação de assistência aos membros da comunidade é uma contribuição inestimável para o projeto.

• Partilhe conhecimentos: utilize os seus conhecimentos e experiência para fornecer respostas úteis e informativas às questões levantadas pelos membros da comunidade. Ofereça explicações, exemplos e referências claras para apoiar as suas respostas.
• Ajude a resolver problemas: ajude os membros da comunidade na solução de problemas técnicos ou na resolução de problemas de configuração encontrados ao usar o kit de ferramentas.

Atualizar documentação

• Identificar áreas a melhorar: Revise a documentação existente para identificar informações desatualizadas, imprecisões ou lacunas que precisem ser resolvidas.
• Melhorar a clareza e a consistência: Esclareça seções ambíguas, reorganize o conteúdo para melhor estrutura e garanta consistência na terminologia, formatação e estilo em toda a documentação.
• Atualizar conteúdo: atualize informações desatualizadas, adicione novo conteúdo para cobrir recursos ou alterações recentes e remova seções obsoletas que não são mais relevantes.

Obrigado!

Suas contribuições para o código aberto, grandes ou pequenas, tornam projetos como este possíveis. Obrigado por dedicar algum tempo a contribuir.

Código de Conduta Aberto da Microsoft

Este projeto adotou o Código de Conduta de Código Aberto da Microsoft.

Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato opencode@microsoft.com com quaisquer outras perguntas ou comentários.