add future API to implement in documentation
Merge pull request #2 from pascalchevrel/api

add future API to implement in documentation