Looks good. Maybe it would be helpful to add in a little section explaining how to determine whether the slowdown is really caused by a too large amount of geoms or polygons, and whether or not animations are the bottleneck; both of which can be analysed using PStats.
You need to highlight Python code. So yes, all Python code should be enclosed in
tags and not
tags.