We have had a very similar experience, and I was a paying customer the first day they launched. However, over the month of migrating documentation - we discovered a couple of areas really lacking:
1. Having to use JS too often and they only offered it in their higher plans,
2. surprisingly poor md support. I don't usually write markdown in visual blocks.
In the end, we built an aggregation of open-source tools to create something similar to the effect of readme - https://github.com/appbaseio/docbase. It uses github for markdown editing and versioning, flatdoc for rendering docs, and creates a beautiful single page routing for the doc. http://docs.appbase.io is using it.
1. Having to use JS too often and they only offered it in their higher plans,
2. surprisingly poor md support. I don't usually write markdown in visual blocks.
In the end, we built an aggregation of open-source tools to create something similar to the effect of readme - https://github.com/appbaseio/docbase. It uses github for markdown editing and versioning, flatdoc for rendering docs, and creates a beautiful single page routing for the doc. http://docs.appbase.io is using it.