Adding documentation for common piftall that leads to exceptions

[manumafe98]

Related issue: #31

I created this starting PR to get some feedback, if this is enough or need some deeper explanation of the annotation/exceptions, Thanks in advance!

[pivotal-cla]

@manumafe98 Please sign the Contributor License Agreement!

Click here to manually synchronize the status of this Pull Request.

See the FAQ for frequently asked questions.

[pivotal-cla]

@manumafe98 Thank you for signing the Contributor License Agreement!