More documentation and proposing new API