Devemos explicar o problema claramente e identificar detalhes adicionais que a equipe precise saber. Devemos aqui descrever o contexto, o que foi feito até agora e o estado atual.
A descrição também serve como uma trilha à qual podemos voltar no futuro para entender o raciocínio que tínhamos na época e ver quais restrições e requisitos mudaram.
| <?php | |
| namespace Admin\Controller; | |
| use Zend\View\Model\ViewModel; | |
| use Core\Controller\ActionController; | |
| use Admin\Model\User; | |
| use Admin\Form\User as UserForm; | |
| use Doctrine\ORM\EntityManager; |
| ├── README.md | |
| ├── go.mod | |
| ├── go.sum | |
| ├── cmd | |
| │ ├── api | |
| │ │ └── main.go | |
| │ └── appctl | |
| │ └── main.go | |
| ├── config | |
| │ ├── config.go |
| ├── cmd | |
| │ ├── api | |
| │ │ └── main.go | |
| │ └── appctl | |
| │ └── main.go |
| ├── book | |
| │ ├── book.go | |
| │ ├── service.go | |
| │ ├── service_test.go | |
| │ ├── mock | |
| │ │ ├── use_case.go | |
| │ │ ├── repository.go | |
| │ ├── postgres | |
| │ │ ├── book_storage.go | |
| │ │ ├── book_storage_test.go |
We must explain the problem clearly and identify additional details that the team needs to know. We must here describe the context, what we did so far, and the current state.
The description also serves as a trail that we can go back to in the future to understand the reasoning we had at the time and see what restrictions and requirements have changed.