fix warning & add documentation