[not ready] Docs updates

about to ping a bunch of people about TODOs here, be ready
I assume "line" can only be used on LineStrings and not Points or Polygons -- y/n? @ansis