> I'm not sure what this means. Is this a manual process I have to do or do you have an API call I can hook into my build system?
We do have an API and a CLI tool for automating, or you can sync it in the UI.
> Is having a Swagger or OpenAPI file a requirement? If not, what's the alternative?
Nope, we have a manual editor in the UI for describing your API!
> How does the changelog work?
It's just a blog mostly, but with icons for different types of changes
> Do you read it out of a git repo or manage it on the site?
Everything is on the site, since locking it in git makes it tougher for non technical coworkers to make changes. That being said, you can sync it to git. We have built in page history, versioning, and our own version of pull requests called "suggested edits".
> I have more questions along those lines and I think some screenshots or documentation for actually using the readme documentation product would help a lot.
You can see your docs at https://docs.readme.com
Thanks for the detailed feedback!
