more doc and better layout