cleaned up architecture and standardized link & file mentions.