We've answered most of your question in our blog, take a look at https://blog.prismic.io

It is very hard to talk technical specificities on the homepage while staying understandable for everyone. There is a big room for improvement for sure (and that's what we're targeting), so thanks for your feedback.

Also we'll keep working on our API and development kits documentation, any help is appreciated.

Our API has a cache forever semantics explained here https://blog.prismic.io/UzQYNwEAAGIjZ3UZ/immutable-documents...

It is a Restful API, that's why there is a single entry point, all follows programatically from there.