beginning to write documentation on mirroring