docs(select): add more notes about ngRepeat and clean up style

I added a note to make more clear when to use ngRepeat or ngOptions.

I also organized the text in the ngOptions section to flow better and use less alert divs