Added some documentation suggestions in []
merged comments