It's frustrating as this product looks like a great idea and looks well done, but you're leaving out all the important bits of information that I'd want to know immediately.
Do I have to request the the content from prismic with every request? Is it done client or server side? What kind of caching will I be able to do my end? What happens when you go down?
That website and especially the video are terrible at communicating (pan, pan, pan, pan, pan, arghhhhhh). I thought it was because I was watching it without sound. Turns out there is no sound.
It visually looks great, but the content itself is practically useless, classic style over substance.
And the API documentation is bad. What does the first section of the documentation even mean?
/api is the single endpoint of your content repository. You can learn and browse everything else from there. You should never forge any API URL in your code, as all usable forms (that define what URLs you can build) are available in /api (and the URLs might change as features get rolled out).
I (finally) found the api which is hidden in the help menu of all places and kinda can guess what you're supposed to do, but I think you've a few rough edges to sand off in the usability.
Gratz on the launch, but get someone in to help you write the copy and overhaul those API docs.
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.
Take this as a positive criticism. Good looking website but it me took too long to get it. Not really sure if I still fully got it.
The site doesn't really doesn't say what it is. "Manage your content in one place. Display it your way. Using your favorite technology. prismic.io is a different approach to content management." - all that seems like filler text to me.
I watched the video. It was way too complex. All the close up shots, error messages, etc. Make it simpler.
btw. I wouldn't go searching answer to API questions in a blog.
Comments
It's frustrating as this product looks like a great idea and looks well done, but you're leaving out all the important bits of information that I'd want to know immediately.
Do I have to request the the content from prismic with every request? Is it done client or server side? What kind of caching will I be able to do my end? What happens when you go down?
That website and especially the video are terrible at communicating (pan, pan, pan, pan, pan, arghhhhhh). I thought it was because I was watching it without sound. Turns out there is no sound.
It visually looks great, but the content itself is practically useless, classic style over substance.
And the API documentation is bad. What does the first section of the documentation even mean?
/api is the single endpoint of your content repository. You can learn and browse everything else from there. You should never forge any API URL in your code, as all usable forms (that define what URLs you can build) are available in /api (and the URLs might change as features get rolled out).
I (finally) found the api which is hidden in the help menu of all places and kinda can guess what you're supposed to do, but I think you've a few rough edges to sand off in the usability.
Gratz on the launch, but get someone in to help you write the copy and overhaul those API docs.
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.
Take this as a positive criticism. Good looking website but it me took too long to get it. Not really sure if I still fully got it.
The site doesn't really doesn't say what it is. "Manage your content in one place. Display it your way. Using your favorite technology. prismic.io is a different approach to content management." - all that seems like filler text to me.
I watched the video. It was way too complex. All the close up shots, error messages, etc. Make it simpler.
btw. I wouldn't go searching answer to API questions in a blog.