Add some notes about 'params' parameter and fix #18