another checkpoint on README - trying to nail down rest docs formatting