more documentation for API..