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
maybe add "being faster by not creating a new scope for each `<option>` element"?