added oil design doc, a work in progress.

It's not linked from anywhere for now but I still thought I'd commit it.