docs: add linters description

[AlduLonghi]

What?

resolves #3927

The idea was to add the description for each linter before the snippet in the /linters section.

Additional
I added a formatting function that normalizes all linters' descriptions. This function uppercases the first letter and adds a final dot if missing.

Why?

This is for better understanding so the user doesn't have to scroll all the way up to read the linter's description.

How?

I call the function GetAllSupportedLinterConfigs() and create a map with each linter's name and description. This way I decrease the complexity since I use just one loop to make it and the later search is O(1).

Testing?

Everything is working fine.

Screenshots

From this:

To this:

Additional

From this:

To this:

Looking forward to your comments :)

[boring-cyborg]

Hey, thank you for opening your first Pull Request !

[CLAassistant]

All committers have signed the CLA.

[ldez]

Hello,

Thank you for your contribution to our project.
Your PR will benefit many users.

I watched your profile and you seem to have frontend knowledge, we have currently a problem with gatsby in the documentation build (#3864, #3934), can you help us with that?

[AlduLonghi]

Hey @ldez! Thank you.

I do have frontend knowledge but I actually never worked with Gatsby before. But let me take a look at the issues and I'll see what I can do about them :)

[ldez]

@AlduLonghi have you taken a look? Can you help us?

If you cannot it's not a problem, I'm just trying to use the opportunity 😺.

[AlduLonghi]

Hi @ldez! I've been exploring it the past week and it has to do with Gatsby Migration from v4 to v5. There are some plugins that are not migrated to their latest versions (some needed to be migrated during gatsby migration v3 - v4) and they need code refactoring to function correctly. Is this just this rabbit hole of migrating everything and checking everything works correctly. I might be able to take this next week if that's ok :)