better explanations and sudo code now in README