improved documentation about the trading method