Rework github README to better reflect POD documentation.

Reorganize readme and POD to better mirror each other.