Versão em português aqui.

Image for post
Image for post

It is very easy to use a build tool without understanding 10% of what that large amount of code is doing. That is because generally the build settings of an application don’t change much, so if you start working on an existing project, chances are great that you won’t need to make big changes on that block of code.

So, I decided to write this article that demystifies some uses that we make in Gradle and that we don’t even understand very well where it comes from.

For the purposes of this article, I will use a Gradle script from an API in Kotlin. The script is written using the Gradle Kotlin…


Versão em português aqui.

Image for post
Image for post

From time to time I like to remember the concepts behind the tasks I do as a software developer. …


Versão em português aqui.

This discussion arises from time to time in my daily life. Different people, different points of view, that make us go through different paths to always answer the same question.

The answer does not usually change: it depends.

In the case of less complex cases, where we are applying the concepts of REST to a CRUD, there will rarely be times when we need an endpoint that contains a verb.
When we have applications with more complex behaviors, then this type of questioning arises.

Definitions

Verb: Class of words that, from a semantic point of view, contains the notions of action, process or state.
Noun: Word that names a class of things, people, animals, etc. …


Image for post
Image for post

Versão em português aqui.

It has been a while since ADRs became popular. Architecture Decision Records are used to align technical decisions and also keep the next people updated on the motivation of past decision making. This practice is used in a code base, team or even area level.

Speaking specifically of the code base, developers should know that it is very difficult to keep documentation up to date. In fact, this phenomenon of difficulty in updating documentation should be studied, because it is a recurring problem worldwide 😛. …


English version here.

Ícone do Kotlin e Ícone do gradle com um coração no meio
Ícone do Kotlin e Ícone do gradle com um coração no meio

É muito fácil usar uma ferramenta de build sem entender 10% do que aquele monte de código está fazendo. Isso porque geralmente as configurações de build de uma aplicação não mudam muito, então se você começa a trabalhar num projeto já existente, grandes são as chances de você não precisar mudar muito aquele bloco de código.

Por isso resolvi escrever este artigo que desmistifica alguns usos que fazemos no Gradle e nem entendemos muito bem da onde vem.

Para fins deste artigo, irei utilizar um script Gradle de uma API em Kotlin. …


Image for post
Image for post
fonte: https://codepen.io/jh3y/pen/NLzEJX

Não é justo com clientes da sua API retornar um erro 500 toda vez que o propósito do código não foi cumprido. Segue definição do MDN Web Docs:

Quando o servidor retorna um código de erro (HTTP) 500 indica que encontrou uma condição inesperada e que o impediu de atender à solicitação.
[…] Às vezes, os arquivos log de servidores podem responder com um status code 500 acompanhado de mais detalhes sobre o request para evitar que no futuro erros desse tipo possam voltar a acontecer.

Ou seja, se o servidor respondeu com status 500, você deveria escrever um código que corrija esse comportamento para as próximas vezes. …


English version here.

Essa discussão surge de tempos em tempos no meu dia-a-dia. Pessoas diferentes, pontos de vista diferentes, que fazem a gente percorrer diversos caminhos para responder sempre a mesma dúvida.

A resposta não costuma mudar: depende.

Em se tratando de casos poucos complexos, onde estamos aplicando os conceitos de REST para um CRUD, raras serão as vezes onde precisamos de um endpoint que contém um verbo.
Já quando temos aplicações com comportamentos mais complexos, aí sim que surge esse tipo de questionamento.

Definições

Verbo: Classe de palavras que, do ponto de vista semântico, contêm as noções de ação, processo ou estado.
Nome: Palavra ou locução com que se designa uma classe de coisas, pessoas, animais, etc. …


Image for post
Image for post

De tempos em tempos eu gosto de relembrar os conceitos por trás das tarefas que faço como desenvolvedora. …


Image for post
Image for post

English version here.

Já faz um tempo que ADRs se popularizaram. Architecture Decision Records, em português Registros de Decisão de Arquitetura, são utilizados para alinhar decisões técnicas e também manter as próximas pessoas atualizadas na motivação das tomadas de decisão do passado. Essa prática é utilizada em nível de base de código, times ou até mesmo de áreas.

Falando especificamente de base de código, nós devs sabemos que é muito difícil manter uma documentação atualizada. Aliás, deveria ser estudado esse fenômeno de dificuldade de atualização de documentações, porque é um problema recorrente no mundo todo 😛. …


Logo do slack
Logo do slack

Aqui na Creditas nós usamos o Slack assiduamente para comunicação do dia-a-dia. No momento atual que estamos vivendo, a empresa foi bem rápida ao instaurar o trabalho remoto para todos os tripulantes.
Por sorte, muitas outras empresas têm feito o mesmo e isso me motivou a escrever um artigo sobre boas práticas no uso do Slack. Essas práticas já são mencionadas por nós internamente, o que fiz foi compilar e expôr para que todas tenham acesso. As dicas são:

Ninguém vai te achar mal-educada por ir direto ao ponto na sua mensagem. Você pode claro mandar um bom dia ou tudo bem se você realmente achar que precisa, mas não espere a resposta para dizer pra que de fato veio. …

About

Software Developer. I write code that humans can understand.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store