revised year2.md & docs