more clearer and linky docs