add additional docs in comments