more clearer

included bugs, and directions