Nos próximos tópicos irei explorar alguns temas importantes no que tangem organização no geral, ferramentas para usar no dia-a-dia e formas de automatizar as coisas para um melhor desempenho no seu dia.

Ferramentas

Markdown Language

Para começar eu gosto bastante de usar linguagem de Markdown para minhas anotações, é uma relação de “ganha ganha”, onde você tem um método rápido para digitar e ainda consegue aprender para fazer documentações no geral.

Obsidian

Outra coisa que gosto de fazer é usar o Obsidian para organizar esses arquivos. No artigo iremos explorar várias features da ferramenta, mas toda a parte de organização pode ser feita na ferramenta de sua escolha, sendo ela o Vs Code ou o Notion.

Excalidraw

Caso precise desenhar coisas simples, como caixas se conectando ou HLAs (High Level Architecture), eu recomendo o Excalidraw por ser mais bonito e simples do que o draw.io.

Organização

Eu organizei minhas anotações na seguinte estrutura de pastas:

|Vault
├───Assets
│   ├───Documentos
│   ├───Dotfiles
│   ├───Excalidraw
│   ├───Images
│   └───Templates
├───Common
├───Corporativo
│   ├───Eventos
│   └───Squad
│       ├───Cerimonias
│       ├───Débitos Técnicos
│       ├───Monitoramento
│       ├───Projetos
│       ├───Releases
│       ├───Rotinas
│       ├───Spikes
│       └───Sustentação
└───Pessoal
    ├───Diário
    ├───Documentos
    ├───PDI
    └───Tech

Não se preocupe. Tudo estará no github

Algumas notas sobre a organização de pastas:

• A pasta assets será responsável por guardar todas as coisas que não serão criadas por você + templates;
• Na pasta corporativo ficarão todas as coisas da sua organização. Eu criei alguns itens como eventos e dentro da squad estão coisas mais específicas do time em que vc estiver trabalhando;
• Na pasta common ficarão coisas que pertencem aos dois mundos, como emails e chamados;
• Dentro de pessoal estarão todas as coisas das quais você será o responsável exclusivo;

Se vc for usar outro aplicativo para anotações sinta-se a vontade para terminar o artigo por aqui.

Obsidian

Vamos agora a algumas configurações específicas do Obsidian. Ao abrir ele pela primeira vez você se deparará com a seguinte tela:

Daqui em diante você pode colar os arquivos que estão no Github direto no diretório onde criou o seu Vault. Após isso, vamos colocar os templates para funcionar.

Em configurações selecione Daily Notes e coloque essas configurações:

Date Format:

[Anotações de] DD [de] MMM [de] YYYY

New file location:

Pessoal/Diário

Template file location:

Assets/Templates/Diário Template

Ficando assim:

Depois disso vá em templates e coloque as seguintes configurações:

Date format:

DD/MM/YYYY

Template folder location:

Assets/Templates

Ficando assim:

Para usar um template dentro de uma nota, basta digitar ctrl+p e buscar a opção inserir modelo

Plugins

Uma vantagem do Obsidian é a possibilidade de usar plugins para personalizar a sua experiência. No meu caso coloco algumas recomendações para o dia-a-dia comum:

Plugins da comunidade:

• Reminder => Coloca lembretes em notas e te avisa com notificações em tela.
• Excalidraw => Possibilita a criação de diagramas do Excalidraw sem precisar sair do Obsidian.
• Calendar => Adiciona um calendário no menu lateral do Obsidian para ter um tracking melhor das suas notas.
• Emoji Shortcodes => Como o nome diz possibilita a inserção de emojis via short code, como um 😄.

Core plugins:

• Slides => Habilita a criação de slides, estilo PowerPoint dentro do próprio Obsidian.
• Sync => O maior downside desse aqui é que ele é pago, mas possibilita muita flexibilidade para levar suas notas de um lugar para o outro.

Caso não deseje pagar, você pode usar o SyncThing.

Com todo esse toolkit você nunca mais será pego desprevenido novamente! Até mais!

• Comportamental
• Técnico
• Burocrático

Dentro desses temas separaria em mais alguns sub-temas, sendo esses:

Comportamental

Comunicação

É importante entender que o que fazemos é escrever códigos para pessoas, principalmente quando se atua em linguagens de alto nível como Java, C#, Python ou qualquer outra da sua escolha. Mas, mais importante que isso é lidar com o fato de que outra pessoa esta ao seu lado querendo tanto quanto você que aquele “troço” rode.

Cercado de idiotas - Thomas Erikson Aqui você terá uma ideia sobre os diferentes tipos de personalidade e como lidar com cada um.

Canal do Youtube do Cal Newport (em Inglês) É um escritor americano que fala sobre temas de produtividade e convívio social como um todo, vale a pena tanto ouvir os podcasts quanto ler seus livros.

Como fazer amigos em influenciar pessoas - Dale Carnegie Esse livro é um clássico, não há muito que falar sobre ele. Somente leia.

Resolução de problemas

O seu dia-a-dia será cheio de problemas para resolver, pois no fim das contas nós como desenvolvedores somos isso: resolvedores de problemas. Existe muito pouco sobre o tema e acredito que o mesmo seja um universo a ser explorado.

Usando técnicas de algoritmos para resolver problemas (em Inglês)

Aprendizado contínuo

Aqui não existe muito segredo. Você estará inserido em um mercado em ascensão, e isso implica em ter q se adaptar e aprender tudo toda vez. Nesse ramo você pode seguir blogs, influencers ou canais no Youtube, mas vou deixar algumas recomendações dentro da seção de conhecimentos técnicos.

Você também pode se aprofundar na arte do “aprender a aprender”, mas isso eu vou deixar com você.

Técnico

Aqui será o seu ponto de partida para ser inserido no mercado, afinal se você for alguém que saiba se comportar corretamente mas não saiba nada técnico, você acabará fazendo algo mais voltado ao público, e desenvolvimento de software é uma tarefa árdua e (as vezes) solitária.

Clean Code - Uncle Bob Já se perguntou como dar um nome para um método? Ou ainda quantos parâmetros ele deveria ter? Esse livro responde várias perguntas e te deixa com várias outras para ser descobertas por você mesmo.

Mythical man month - Frederick P. Brooks Jr Tudo sobre gerenciamento de projetos. Como uma equipe deveria funcionar e mais algumas coisas que foram fundamentais para o ágil como é hoje.

Tim Corey (em Inglês) Ótimo canal no Youtube sobre desenvolvimento de software, carreira e os problemas comuns que todo desenvolvedor passa no seu dia-a-dia.

Existem alguns termos que você precisa se familiarizar também, se aprofundando ou simplesmente sabendo o que são. São eles:

• SOLID
• POO (ou Programação Orientada a Objeto)
• KISS, DRY, YAGNI (esses são conceituais)
• Object Calisthenics

Burocrático

Nem tudo são flores no mundo do desenvolvimento de software, você vai precisar aprender sobre coisas que não estão dentro do escopo simplesmente pq o framework da empresa roda de um jeito. Não tenho links nem livros em específico, então mais uma vez confio em você para fazer uma pesquisa aprofundada sobre esses temas, sendo eles:

• SCRUM
• Ferramentas de gerenciamento de tempo (Jira, Azure Devops)
• Ciclo de vida de aplicações
• Suporte a aplicação (You Build It You Run It, ITIL)

Considerações finais

Não digo para ler até o final todos os livros que estão aqui (apesar de serem ótimas recomendações), mas pelo menos coloque algumas sementes na sua cabeça do que está sendo dito neles, afinal aprendizado se trata disso, pq no final das contas ninguém vai fazer as coisas por você.

Outra recomendação que deixo é o site https://roadmap.sh/, nele você obtém rotas de aprendizado para diversas roles dentro do mundo de tecnologia. Acho que mais importante que ler as coisas acima, é decidir o que você quer fazer depois de passar por alguns roadmaps desse site (não necessariamente nessa ordem).

Isso é tudo, see ya!

Alguma vez você já ficou irritado com o fato de precisar fazer um cherry-pick de uma branch para outra, e se deparar com esse cenário:

$ git log --oneline
f54530a (HEAD -> master) fix: Corrigindo mais informacoes ao arquivo
19dc69d fix: Corrigindo informacoes ao arquivo
969e9bf feat: Adicionando informacoes ao arquivo
bf1327d feat: criando repo

Como boa prática vc sempre deve comitar suas alterações sempre que possível, mas no minímo ao fim do dia.

Para que vc não fique com um excesso de commits a serem levados da sua branch feature para uma branch fixa vc pode usar o squash para juntar todos os caras em um só.

Tá, legal. Mas o que eu faço?

Para resolver esse problema vamos juntar os commits em um só, uma vez que a sua task era somente uma implementação de um arquivo e não todas essas correções que vc fez no meio do caminho.

Se vc consegue dar um commit só e já resolver o problema esse artigo não é pra vc, é para humanos normais.

Primeiro vc precisa aglutinar os commits em um só usando o git rebase passando como referencia a quantidade de commits a serem unidos:

git rebase -i HEAD~<quantidade de commits>

Para o caso acima o comando fica assim:

git rebase -i HEAD~3

Ao fazer isso será aberto um arquivo de texto no vim (sim o vim!) e lá vc deverá alterar o commit que vc quer aglutinar, sendo eles marcados com a tag squash e o commit final com a tag pick.

pick 969e9bf feat: Adicionando informacoes ao arquivo
squash 19dc69d fix: Corrigindo informacoes ao arquivo
squash f54530a fix: Corrigindo mais informacoes ao arquivo

# Rebase bf1327d..f54530a onto bf1327d (3 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup [-C | -c] <commit> = like "squash" but keep only the previous
#                    commit's log message, unless -C is used, in which case
#                    keep only this commit's message; -c is same as -C but
#                    opens the editor
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
#         create a merge commit using the original merge commit's
#         message (or the oneline, if no original merge commit was
#         specified); use -c <commit> to reword the commit message
# u, update-ref <ref> = track a placeholder for the <ref> to be updated
#                       to this position in the new commits. The <ref> is
#                       updated at the end of the rebase
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#

Um segundo arquivo será aberto perguntando se vc deseja adicionar alguma mensagem adicional de commit, se não quiser é só salvar e seguir em frente.

Tome cuidado para não ficar preso para sempre no VIM

pick 969e9bf feat: Adicionando informacoes ao arquivo
# This is a combination of 3 commits.
# This is the 1st commit message:

feat: Adicionando informacoes ao arquivo

# This is the commit message #2:

fix: Corrigindo informacoes ao arquivo

# This is the commit message #3:

fix: Corrigindo mais informacoes ao arquivo

# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# Date:      Tue Jul 30 17:14:42 2024 -0300
#
# interactive rebase in progress; onto bf1327d
# Last commands done (3 commands done):
#    squash 19dc69d fix: Corrigindo informacoes ao arquivo
#    squash f54530a fix: Corrigindo mais informacoes ao arquivo
# No commands remaining.
# You are currently rebasing branch 'master' on 'bf1327d'.
#
# Changes to be committed:
#       modified:   ArquivoComDados.txt
#
# This is a combination of 3 commits.
# This is the 1st commit message:

feat: Adicionando informacoes ao arquivo

# This is the commit message #2:

fix: Corrigindo informacoes ao arquivo

# This is the commit message #3:

fix: Corrigindo mais informacoes ao arquivo

# Please enter the commit message for your changes. Lines starting

Saindo do vim, vc terá o seguinte retorno ao rodar o comando git log –oneline:

$ git log --oneline
8ef96ee (HEAD -> master) feat: Adicionando informacoes ao arquivo
bf1327d feat: criando repo

Para enviar para o repositório remoto vc precisará usar o comando de force no push, uma vez que o commit local difere do remoto. O comando exato é o git push origin BRANCH-REMOTA –force

Por hoje é isso, see ya.