Skip to content

Commit

Permalink
Adds templates for Bug Report and Feature Request
Browse files Browse the repository at this point in the history
- Creates a template for Bug Report with the following fields:
 - Terms of acceptance
 - Detailed description of the problem
 - Expectation versus observation
 - Screenshots/videos
 - API version
 - Environment
 - Additional environment specifications
 - Logs (if applicable)
 - Additional notes

- Create a template for Resource Request with the following fields:
 - Terms of acceptance
 - Type of resource
 - Motivation for the request
 - Usage examples
 - Development ideas
 - Additional notes
  • Loading branch information
jrCleber committed May 29, 2024
1 parent 4135af9 commit 76d490c
Show file tree
Hide file tree
Showing 5 changed files with 430 additions and 151 deletions.
91 changes: 70 additions & 21 deletions .github/ISSUE_TEMPLATE/bug_report_br.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,26 +3,24 @@ description: Create a report to help us improve.
labels:
- bug
- help wanted
- pt-br
assignees: jrcleber
body:
- type: checkboxes
id: terms
- type: markdown
attributes:
label: Bem-vido!
description: |
value: '## Bem-vindo!'

- type: markdown
attributes:
value: |
O rastreador de problemas é apenas para relatar bugs e solicitações de recursos.
Para perguntas de suporte relacionadas ao usuário final, acesse o [Grupo](https://chat.whatsapp.com/HyO8X8K0bAo0bfaeW8bhY5).
NÃO ABRA UM PROBLEMA PARA PERGUNTAS GERAIS DE SUPORTE.
**NÃO ABRA UM PROBLEMA PARA PERGUNTAS GERAIS DE SUPORTE.**
options:
- label: Sim, pesquisei problemas semelhantes no [GitHub](https://github.com/code-chat-br/whatsapp-api/issues) e não encontrei nenhum.
required: true

- type: textarea
- type: markdown
attributes:
label: O que você fez?
description: |
value: |
Como escrever um bom relatório de bug?
- Respeite o modelo de problema tanto quanto possível.
Expand All @@ -31,37 +29,75 @@ body:
- O contexto deve levar a algo, ideia ou problema que você está enfrentando.
- Seja claro e conciso.
- Formate suas mensagens para ajudar o leitor a se concentrar no que importa e entender a estrutura da sua mensagem, use [sintaxe Markdown](https://help.github.com/articles/github-flavored-markdown)
placeholder: O que você fez?
---
- type: checkboxes
id: terms
attributes:
label: Pesquisei problemas semelhantes no [GitHub](https://github.com/code-chat-br/whatsapp-api/issues) e não encontrei nenhum.
description: Pesquise tanto nas issue abertas quanto nas fechadas.
options:
- label: Sim
required: true

- type: markdown
attributes:
value: '### O que você fez?'
- type: textarea
attributes:
label: 'Quais passos para chegar ao problema?'
placeholder: Descreva
validations:
required: true

- type: markdown
attributes:
value: '### O que você esperava?'
- type: textarea
attributes:
label: O que você esperava?
label: Descreva o que você esperava que acontecesse.
placeholder: O que você esperava?
validations:
required: true

- type: markdown
attributes:
value: '### O que vc observou ao invés do que esperava?'
- type: textarea
attributes:
label: O que vc observou ao invés do que esperava?
label: Explique o que realmente acontece quando você segue os passos acima.
placeholder: O que vc observou ao invés do que esperava?
validations:
required: true

- type: markdown
attributes:
value: '### Qual versão da API você está usando?'
- type: textarea
attributes:
label: Qual versão da API você está usando?
description: |
Insira o número da sua versão que está na propriedade `version` do **package.json**.
label: Insira o número da sua versão que está na propriedade `version` do **package.json**.
placeholder: Cole aqui a versão.
validations:
required: true

- type: markdown
attributes:
value: '### Capturas de Tela/Vídeos'
- type: textarea
attributes:
label: |
Se possível, adicione capturas de tela ou vídeos que ilustrem o problema.
Isso pode ser extremamente útil para entender melhor o problema.
placeholder: mídioas que ajudam a identificar o problema

- type: markdown
attributes:
value: '### Qual é o seu ambiente?'
- type: dropdown
id: select
attributes:
label: Qual é o seu ambiente?
label: O ambiente no qual a aplicação está em execução
options:
- Windows
- Linux
Expand All @@ -71,10 +107,23 @@ body:
validations:
required: true

- type: markdown
attributes:
value: '### Se aplicável, cole a saída do log'
- type: textarea
attributes:
label: Se aplicável, cole a saída do log
description: "`console da aplicação`"
label: |
Por favor, anexe os logs que possam estar relacionados ao problema.
Se os logs contiverem informações sensíveis, considere enviá-los de forma privada para um dos mantenedores do projeto.
placeholder: Cole aqui o log da aplicação
validations:
required: false

- type: markdown
attributes:
value: '### Notas Adicionais'
- type: textarea
attributes:
label: Inclua aqui qualquer outra informação que você ache que possa ser útil para entender ou resolver o bug.
validations:
required: false
179 changes: 114 additions & 65 deletions .github/ISSUE_TEMPLATE/bug_report_en.yaml
Original file line number Diff line number Diff line change
@@ -1,80 +1,129 @@
name: Bug Report (CodeChat - EN)
name: Bug Report (CodeChat)
description: Create a report to help us improve.
labels:
- bug
- help wanted
- en
assignees: jrcleber
body:
- type: checkboxes
id: terms
attributes:
label: Welcome!
description: |
The issue tracker is only for reporting bugs and feature requests.
For end-user related support questions, please visit [Group](https://chat.whatsapp.com/HyO8X8K0bAo0bfaeW8bhY5).
- type: markdown
attributes:
value: '## Welcome!'

DO NOT OPEN AN ISSUE FOR GENERAL SUPPORT QUESTIONS.
- type: markdown
attributes:
value: |
The issue tracker is only for reporting bugs and feature requests.
For end-user support questions, please visit the [Group](https://chat.whatsapp.com/HyO8X8K0bAo0bfaeW8bhY5).
options:
- label: Yes, I searched for similar issues on [GitHub](https://github.com/code-chat-br/whatsapp-api/issues) and didn't find any.
required: true
**DO NOT OPEN AN ISSUE FOR GENERAL SUPPORT QUESTIONS.**
- type: textarea
attributes:
label: What did you do?
description: |
How to write a good bug report?
- type: markdown
attributes:
value: |
How to write a good bug report?
- Respect the problem model as much as possible.
- The title must be short and descriptive.
- Explain the conditions that led you to report this problem: the context.
- The context should lead to something, idea or problem you are facing.
- Be clear and concise.
- Format your messages to help the reader focus on what matters and understand the structure of your message, use [Markdown syntax](https://help.github.com/articles/github-flavored-markdown)
placeholder: What did you do?
validations:
required: true
- Follow the issue template as much as possible.
- The title should be short and descriptive.
- Explain the conditions that led you to report this issue: the context.
- The context should lead to something, an idea or problem you are facing.
- Be clear and concise.
- Format your messages to help the reader focus on what matters and understand the structure of your message, use [Markdown syntax](https://help.github.com/articles/github-flavored-markdown)
- type: textarea
attributes:
label: What did you expect?
placeholder: What did you expect?
validations:
required: true
---
- type: textarea
attributes:
label: What did you observe instead of what you expected?
placeholder: What did you observe instead of what you expected?
validations:
required: true
- type: checkboxes
id: terms
attributes:
label: I have searched for similar issues on [GitHub](https://github.com/code-chat-br/whatsapp-api/issues) and found none.
description: Search both open and closed issues.
options:
- label: Yes
required: true

- type: textarea
attributes:
label: Which API version are you using?
description: |
Enter your version number that is in the `version` property of **package.json**.
placeholder: Paste the version here.
validations:
required: true
- type: markdown
attributes:
value: '### What did you do?'
- type: textarea
attributes:
label: 'Steps to reproduce the issue'
placeholder: Describe
validations:
required: true

- type: dropdown
id: select
attributes:
label: What is your environment?
options:
- Windows
- Linux
- Mac
- Docker
- Other
validations:
required: true
- type: markdown
attributes:
value: '### What did you expect?'
- type: textarea
attributes:
label: Describe what you expected to happen.
placeholder: What did you expect?
validations:
required: true

- type: textarea
attributes:
label: If applicable, paste the log output
description: "`application console`"
placeholder: Paste the application log here
validations:
required: false
- type: markdown
attributes:
value: '### What did you observe instead of what you expected?'
- type: textarea
attributes:
label: Explain what actually happens when you follow the steps above.
placeholder: What did you observe instead of what you expected?
validations:
required: true

- type: markdown
attributes:
value: '### Which version of the API are you using?'
- type: textarea
attributes:
label: Enter the version number found in the `version` property of **package.json**.
placeholder: Paste the version here.
validations:
required: true

- type: markdown
attributes:
value: '### Screenshots/Videos'
- type: textarea
attributes:
label: |
If possible, add screenshots or videos that illustrate the issue.
This can be extremely helpful to better understand the issue.
placeholder: media that helps identify the issue

- type: markdown
attributes:
value: '### What is your environment?'
- type: dropdown
id: select
attributes:
label: The environment in which the application is running
options:
- Windows
- Linux
- Mac
- Docker
- Other
validations:
required: true

- type: markdown
attributes:
value: '### If applicable, paste the log output'
- type: textarea
attributes:
label: |
Please attach any logs that might be related to the issue.
If the logs contain sensitive information, consider sending them privately to one of the project maintainers.
placeholder: Paste the application log here
validations:
required: false

- type: markdown
attributes:
value: '### Additional Notes'
- type: textarea
attributes:
label: Include any other information you think might be useful to understand or resolve the bug.
validations:
required: false
Loading

0 comments on commit 76d490c

Please sign in to comment.