Instance methods docs

There are two doc changes here.
* 559abaf fixes the docs. They used to say, "with no arguments `instance_methods` the methods of ancestors are not included".  This is not true (with no argument then the ancestors methods are included).  I've also updated the examples 
*  39d7023 helps with readability, added `<i>` tags and updated the size of an array in an example