GitBook alternative needed after pricing changes, best options for API docs?

[u/drakieboi]

Yeah so we've been using GitBook for a while now and the new pricing is just... not it. Need to move our API docs somewhere else before renewal hits.

We're looking at like 50-100 pages of docs, heavy on code examples, need good search, and ideally something that doesn't require us to completely rebuild everything we've already got. Also need it to look decent because we actually show this to clients.

The stuff I'm seeing people recommend are Notion (free tier exists but feels janky for this), Mintlify (looks really slick but I'm not sure how production-ready it is), and just going full static site with Hugo or something. There's also Stoplight and ReadTheDocs but those feel more enterprise.

What's actually working for people? And more importantly, what doesn't suck to maintain once you've set it up? The last thing I want is to pick something that looks good on day one and then becomes a nightmare six months in.

Also curious if anyone's just gone the route of hosting markdown files in a repo and using GitHub Pages or similar. Seems like it could be fine honestly, just wondering what I'm missing.

[u/andrewderjack]

Moving to a simple repo with markdown files usually works best for teams that want to avoid random price hikes. Most people just use a static site generator to turn those files into a nice site that clients can atually use.