put down very sparce documentation into examples.clj