fix controller matching documentation and add warning

 fix #134