> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contribuindo

Interessado em contribuir com o AppSignal? Ótimo!

Ajudar é possível de muitas maneiras. Reportando problemas, corrigindo bugs, adicionando
recursos e até mesmo corrigindo erros de digitação. [Avise-nos][contact] se tiver alguma
dúvida sobre como contribuir para qualquer um dos nossos projetos.

Ficamos muito felizes em enviar Stroopwafels para qualquer pessoa que contribua. Dê uma olhada em
todos para quem já enviamos um pacote em nossa [página de Stroopwafels][waffles-page].

## Projetos Open Source

Todos os projetos open source estão disponíveis em nossa [organização do AppSignal no GitHub][github-appsignal].

Nossos principais projetos incluem:

* [Biblioteca AppSignal para Ruby][appsignal-ruby]
* [Biblioteca AppSignal para Elixir][appsignal-elixir]
* [Biblioteca JavaScript Front-end do AppSignal][appsignal-javascript]
* [Biblioteca AppSignal para Node.js][appsignal-nodejs]
* [Aplicações de exemplo do AppSignal][appsignal-examples]

Outros projetos que tornamos open source, e são usados internamente por outros projetos,
incluem:

* [Agente AppSignal em Rust][appsignal-rust]
  Prova de conceito em estágio inicial da integração AppSignal em Rust.
* [sql\_lexer][sql_lexer]
  Biblioteca Rust para fazer lexing e sanitização de consultas SQL.
* [probes.rs][probes-rs]
  Biblioteca Rust para ler estatísticas do sistema de uma máquina rodando Linux.
* [public\_config][public_config]
  Partes da configuração do AppSignal.com que são públicas, como os magic dashboards.

## Usando git e GitHub

Organizamos a maioria dos nossos repositórios git no GitHub usando uma branch `main` e
uma branch `develop`. A branch `main` corresponde ao release estável atual
de um projeto. A branch `develop` é usada para o desenvolvimento de recursos
que estarão no próximo release minor de um projeto.

Feature branches são usadas para enviar correções de bugs e novos recursos usando Pull
Requests no GitHub. Ao enviar um Pull Request, as mudanças são testadas em uma
variedade de versões de Ruby/Elixir e dependências. A mudança enviada é
também revisada por dois ou mais membros do projeto AppSignal antes de ser aceita.

## Versionamento

O AppSignal é bem transparente sobre mudanças no seu produto. Mudanças em integrações
e na própria aplicação são todas visíveis em
[AppSignal.com/changelog][changelog]. Grandes atualizações também serão postadas em [nosso
blog][blog].

Todos os projetos de integração do AppSignal usam [Versionamento Semântico][semver] para
versionar releases. Projetos de documentação e outros não específicos de versão
não usam versionamento explícito, mas mencionarão conteúdo específico de versão
relacionado, como em qual versão um recurso foi introduzido.

Todo release estável e instável é marcado com uma tag de versão no git e pode
ser encontrado em cada página do projeto no GitHub na seção "Releases".

## Reportando bugs

Reporte um bug abrindo uma issue na página do projeto no GitHub do respectivo
projeto. Se o relatório de bug contiver alguma informação sensível que seja
necessária para o relatório completo, você também pode [entrar em contato conosco][contact] para enviar
o bug.

Quando o bug é uma questão sensível de segurança, consulte a seção [Questões de
segurança](#security-issues).

Ao enviar uma correção de bug, crie um Pull Request na página do projeto no
GitHub, envie a mudança contra a branch `main`.

## Solicitações de recursos

Sentindo falta de um recurso ou integração no AppSignal? Por favor, nos avise quando
algo vier à mente [nos enviando um e-mail][contact] ou enviando uma
issue na página do projeto no GitHub.

Também é possível enviar um recurso em um dos nossos projetos Open Source
criando um Pull Request direcionado à branch `develop` do projeto.

## Questões de segurança

Se você acha que encontrou uma questão de segurança em relação à nossa aplicação,
rede ou integrações, por favor nos avise imediatamente enviando um e-mail para
[security@appsignal.com](mailto:security@appsignal.com).

## Código de Conduta

Espera-se que todos que interagem nas bases de código e rastreadores de issues do AppSignal
sigam o [código de conduta][coc] do contribuidor. Por favor, reporte comportamento
inaceitável para [contact@appsignal.com][coc-contact].

[contact]: mailto:support@appsignal.com

[blog]: https://blog.appsignal.com/

[changelog]: https://www.appsignal.com/changelog

[waffles-page]: https://www.appsignal.com/waffles

[appsignal-ruby]: https://github.com/appsignal/appsignal-ruby

[appsignal-elixir]: https://github.com/appsignal/appsignal-elixir

[appsignal-javascript]: https://github.com/appsignal/appsignal-javascript

[appsignal-nodejs]: https://github.com/appsignal/appsignal-nodejs

[appsignal-rust]: https://github.com/appsignal/appsignal-rs

[appsignal-examples]: https://github.com/appsignal/appsignal-examples

[sql_lexer]: https://github.com/appsignal/sql_lexer

[probes-rs]: https://github.com/appsignal/probes-rs

[public_config]: https://github.com/appsignal/public_config

[github-appsignal]: https://github.com/appsignal

[semver]: http://semver.org/

[coc-contact]: mailto:contact@appsignal.com

[coc]: /appsignal/contributing/code-of-conduct.html