Documentation update and LGTM fixes

[tkornuta-ibm]

This pull request fixes 8 alerts when merging a15f509a52a5b1140821771f0b01033e99e38fe0 into da19390c389ff0835e48d241825372a9f565e44d - view on LGTM.com

fixed alerts:

• 3 for Signature mismatch in overriding method
• 2 for Non-iterable used in for loop
• 1 for __eq__ not overridden when adding attributes
• 1 for Unused local variable
• 1 for Unnecessary delete statement in function

---

Comment posted by LGTM.com