Agneskai Dev

Blog

  • Comentários no VSCode

    Comentários no VSCode

    Ao retomar um projeto parado por duas semanas, percebi duas coisas importantes: Primeiro: Duas semanas podem ser uma eternidade na programação; Segundo: comentários são ferramentas poderosas no desenvolvimento de aplicações.

    A importância da constância

    Um programador, mesmo que trabalhe em uma aplicação pequena ou simples, precisa manter o foco no projeto. Durante o desenvolvimento, surgem soluções para os problemas enfrentados, e novas ideias aparecem naturalmente. Esse foco permite tomar decisões consistentes, resultando em estruturas e funcionalidades harmoniosas ao final do projeto.

    Recentemente, revisitei um projeto que abandonei por um tempo porque estava enfrentando dificuldades em alcançar o resultado que planejei. A ideia era criar uma agregadora de informações financeiras. Embora já existam ótimas plataformas, como Status Invest e Investidor 10, eu queria desenvolver a minha própria. O projeto envolvia HTML e CSS básicos, um pouco de JavaScript para integração das informações, lógica matemática para as calculadoras e, ainda não sei como, uma forma gráfica de apresentar os resultados acumulados da carteira.

    No entanto, fiquei duas semanas sem tocar no código por causa de um quadro que não conseguia implementar como imaginei. Esse intervalo teve um custo alto: perdi o fio da meada e, por causa disso não lembrava onde havia parado, tampouco conseguia explicar as decisões que havia tomado ou a lógica por trás de algumas partes do código. Em um trecho específico, sequer sabia como ele funcionava (mas funcionava).

    Para retomar o projeto, reli todo o código, identifiquei onde cada função atuava e testei se mudanças nos parâmetros mantinham as regras funcionando. O que realmente fez diferença foi adicionar comentários conforme eu esclarecia os pontos do código. Esse processo trouxe vários benefícios.

    A importância dos comentários

    Comentários bem escritos ajudam a entender o propósito de um código ou funcionalidade específica. Eles facilitam o trabalho de revisitar ou modificar o projeto no futuro. Em equipes, permitem que outros desenvolvedores compreendam rapidamente o que está acontecendo, mesmo sem ter trabalhado diretamente naquela parte do código.

    Nem todas as informações de um projeto estarão na documentação oficial, portanto, comentários atuam como uma documentação contextual, próxima ao código. Muitas vezes, decisões técnicas são tomadas por motivos específicos, e explicá-las nos comentários ajuda a preservar esse contexto ao longo do tempo. Além disso, durante a depuração, comentários esclarecem a lógica de trechos complexos, facilitando a identificação de erros.

    Boas práticas para comentários

    Embora este seja o primeiro projeto em que usei comentários extensivamente, percebi que a clareza e a concisão são fundamentais. Comentários objetivos explicam o que o código faz e por que foi escrito daquela forma, evitando redundâncias ou obviedades.

    Seguir um padrão consistente também ajuda quem revisa o código. E, tão importante quanto escrever comentários, é mantê-los atualizados. Sempre que alterar algo no código, revise os comentários relacionados para refletir as mudanças.

  • Iniciando na programação

    Iniciando na programação

    Cada vez mais sentimos a necessidade de estarmos integrados ao digital. É preciso, constantemente, de soluções tecnológicas para tratarmos dos problemas cotidianos e corriqueiros. É comum buscarmos produtos que nos interessam em sites, ou entrarmos em redes sociais para acharmos o contato daquela loja de que só lembramos o nome. De repente, estamos buscando uma roupa, mas não sabemos como combina-la. Para isso, buscamos imagens na internet. Iniciando na programação damos um passo em caminha a essas soluções

    Iniciando na programação

    Ao refletir sobre esses desafios, percebo a área de T.I. se tornando cada vez mais relevante. Se antes consideravam os profissionais de tecnologia como os “profissionais do futuro”, hoje em dia, toda empresa em expansão forma seu próprio time de desenvolvedores, designers, suporte e por aí vai.

    Motivado também pela necessidade de documentar aquilo que pretendo desenvolver, este site terá uma série de postagens relacionadas a temas pertinentes da área de T.I. Inicialmente, haverá uma série de descrições sobre as tecnologias aplicadas aos estudos. No momento, por exemplo, a porta de entrada é a área de Front-End. Portanto, as descrições primárias serão relacionadas à tríade máxima: HTML, CSS e JavaScript.

    Iniciando na programação | Criando a lógica

    Ao iniciar em programação, recomendarei estudar HTML, cujas estruturas são sempre simples. Como a linguagem é de marcação, o objetivo será sempre criar algum tipo de formulário simples ou Landing Page, servindo como base para os estudos de JavaScript, que, imagino, deve ser o coração dos desenvolvedores front-end. Já em CSS, as possibilidades aumentam. O foco principal será aprender o máximo possível da linguagem “pura” antes de adentrar em qualquer framework. Com CSS, será possível criar páginas diferenciadas, aplicando a maior parte dos conhecimentos disponíveis, como flexbox, color grading, proporções e responsividade. Futuramente, escolherei um framework para focar (no momento, o principal concorrente é o Tailwind).

    Agora, em JavaScript, a conversa se complica. No início, você lidará com muitas validações e eventos de alteração de campos. À medida que cria as aplicações, surgirão parâmetros e regras, que aparecerão conforme a necessidade. No momento, devido à falta de conhecimento, não consigo mensurar a quantidade de conteúdos que irei abordar, pois ainda não sei o quanto preciso aprender.

    Finalizando projetos | Versionamento

    Um ponto importante de atenção são as questões relacionadas ao Git. No mercado, é essencial que o profissional que está iniciando na programação conheça alguma ferramenta de versionamento. O GitHub, ao que tudo indica, é a mais conhecida e popular. Por isso, é importante abordar esse tópico com a mentalidade de quem vai trabalhar em projetos e, consequentemente, precisará de um lugar para apresentá-los.

    Avançando | Área de foco

    Avançando nos temas anteriormente apresentados, é notável que o profissional médio deve ter algum conhecimento em banco de dados (se ele focar em Front-End). Em um momento futuro, essa afirmação será melhor abordada, portanto, não a tome como uma verdade absoluta e imutável, mas tenha essa ideia em mente.

    Bancos relacionais, não-relacionais, NoSQL, Node.js e PHP são temas de interesse para mim; entretanto, a falta de conhecimento na área ainda me impede de explorar mais profundamente esses tópicos. Ao projetar o mercado de trabalho, acredito que Python e Power BI também se destacam como importantes. Saber criar é fundamental, mas apresentar essas criações é tão importante quanto. Por isso, criei esta estrutura de estudo, não como uma grade de curso, mas como pontos de interesse para alguém com TDAH iniciando na programação e que deseja continuar aprendendo com prazer na área de tecnologia.