DOC: add more examples to StringMethods on Index
as discussed in https://github.com/pydata/pandas/pull/9667

@jorisvandenbossche please take a look, thanks 

@shoyer good idea, it's updated 
 This looks great to me! I'll just hold off on merging until Joris can take a look.
 Looks good, thanks a lot!
