updated comments in theme - documented