move principles out, finalise index of docs (more or less)