doc: Run style-check and fix all the warnings

[nirandaperera]

I recently ran the build with the stylecheck and found out a significant number of warnings.
We need to do the following

• Enable style check for every build
• Fix the current warnings
• Add pylint and enable python linting