remove notes with potential to confuse the reader

https://github.com/yui/yui3/commit/66d93224c54944170f3b2642060a11c1664851bd