reorganize to be more novice-friendly, add more docs