add notes for "geo apis"
add notes for "reasons your api sucks"
add notes for "scale oriented architecture"