Added some documentation on the new (planned API)