Howdy Govada.
We appreciate you bringing this to our attention. It seems that these documents are out of date. I am going to file a bug to spend some time to update them.
Here's what we would generally recommend:
- Try not to use images more than twice your minimum size. That is to say, don't put a 1000x1000 image in a 10x10 element. Ideally, images should exactly match their container.
- Try to at least specify a ratio of width/height on your images. This way, the browser knows how to reserve space for the image before it downloads it. There are various techniques to do this that you can search for.