added doc and transparency