New file describing the API, splitted from fs.md