Update documentation with real world examples and good practices

[jesusAlvSoto]

When you are new to the project, it is sometimes complicated to figure out where to put things, there is a gap between the examples in the documentation and the day-to-day processes and real-world situations. It would be helpful to know if there are some "good practices" recommended by the core team.