output to commons file, readme update