More than skill set, it’s actually due to a lack of good documentation tools

screen showing a list of files under the heading “documentation”
screen showing a list of files under the heading “documentation”

No matter whether you work in a small startup or a big corporate company, the odds are that when it comes to good, valuable documentation of your services or projects, there will be a huge gap and need for it.

This can impact multiple parts of an organization, from discussion forums to decide the best path to a goal to the onboarding of new colleagues that need to ramp up their knowledge about how your systems are structured and communicate with each other.

But if everyone feels this problem right on their skin, why on earth does this still happen…

And having a super well-designed product is not the priority.

As software engineers, we are used to thinking of whatever we are building as our baby. It must be perfect. To match every pattern that exists on the internet. To be the most scalable thing ever seen, and not to have any flaws. After all, that’s what we’ve been taught all these years.

But when it comes to an urgent need, let it be a business, social, or health need, building quality code might not be the absolute priority. The speed of development might be much more critical than code-quality.

The Most Famous Battle: Quality vs. Speed

Probably all of you have struggled with this at some…

Code smarter, not harder

Image: Phone that says, “Eat, sleep, code, repeat.”
Image: Phone that says, “Eat, sleep, code, repeat.”

Extensions are great. They allow the community to improve a given product according to real-world needs. There are great tools to improve the developer’s productivity by decreasing repetitive tasks, highlighting what you need to see, or making useful commands more accessible.

Visual Studio Extensions

The Visual Studio Marketplace offers a vast quantity of extensions that can turn your IDE into a war tank. There are thousands of extensions available for you to improve your coding experience. Some are free; others you have to pay to use.

However, take into account that you hardly can race with a war tank. Many extensions come with…

It won’t be getting a vaccine or effective treatment

Today is August 25, 2020. The summer is coming to an end. A summer like no other in about a hundred years: where we couldn’t travel as we’d like, we couldn’t go to concerts as we used to, and we couldn’t socialize as we loved to. For many people, those things weren’t even the worst part. They lost their job during the lockdown, or even worst, they lost a loved one to the pandemic.

At this point, in most countries, the use of a mask is mandatory in closed spaces, and some of them even demand its use in any…

5. Programming Is a Men’s Job

Programmers are often seen as non-human creatures that can do magic with their computers. Portraited in Hollywood movies as both the heroes and the villains, these people proceed with their life without being understood by other fellow humans.

In a world that is depending more on technology each day that comes by, the need for IT professionals (let it be software engineers, infrastructure engineers, data scientists, etc.) is turning into an HR nightmare. Finding people that are also looking for a job is almost impossible, and it’s tough to compete with the salaries of the big companies.

However, these profiles…

To innovate will no longer be just releasing another website or app

We have always looked upon Steve Jobs and Bill Gates as the most significant innovation gurus in the world. I mean, Steve Jobs’ Apple revolutionized the way we use our phones, creating the first smartphone along the way, and Microsoft established the widespread use of personal computers. Even nowadays we refer to a general computer as a PC.

These men were the starting point of an entire technological revolution that happened (still happening?) since the ’80s, where people started using computers for personal use. This growth was even more noticeable when the modern Internet was made available in 1995.


If you are growing your exposure, brace yourself for having to deal with criticism.

I am a relatively new writer to Medium. I never had much exposure outside of my inner circle of friends, family, and coworkers. Actually, I started writing to change that trend a little bit. To share my way of thinking and some experience regarding software development and technology in general.

What Happened?

I’ve written some articles where I’ve covered topics from dealing with failure to remote work. Some have generated more attraction than others, but all of them went about 300–1k views.

Last week, I published an article where I shared my thoughts on Scrum, and how switching to Kanban solved a…

Why didn’t Scrum work out?

I’ve been using Scrum since the beginning of my career. This was the framework that I was taught in college as the best to manage software development. When I started working, I loved it all: daily meetings, planning, retrospectives, sprints, etc. After all, I was applying what I learned.

After a few years, I started noticing one thing: In the last days of a sprint, everyone was rushing to deliver everything they had done in the previous two weeks to avoid carry-overs, frequently taking unnecessary risks.

Why? Couldn’t some tasks wait for next week? Was the delivery of every task…

Sometimes, you need to give yourself some rest

Having an application running in production means that they are affecting other people’s lives. It’s a huge responsibility that needs to be well understood before being able to handle an on-call phone.

There are usually two generic ways of knowing if everything is ok with your applications: active monitoring — where you go to the dashboards check for errors and problems, and passive monitoring — commonly called alerts. It’s when a system notifies you about an ongoing issue.

The latter is usually better than the first. You work in the technology sector. As such, you want things to be automatic…

It’s not about your CV

It’s a typical story among the recently graduated people. You finished your studies, and you face the struggle of finding your first job. Some companies are requiring the experience that you don’t have. Others have so many applicants that you’ll be just another fish in the ocean. You begin to question yourself: “How am I supposed to get experience if no one allows me to prove myself?”

Let’s deep dive a little bit.

Why Should a Company Give You a Job?

Maybe this is what you should start questioning. Why should they do it? What do you have that would justify paying a salary? A company exists to…

Emanuel Marques

Software Engineer, fascinated by the impact of technology in our everyday life. Writing about Tech and Personal Development.

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