add documentation for current api impl.