We use git, github, and write our platform doc in markdown.
I’ve noticed that for early drafts of new and lengthy content, markdown & gitHub makes it hard for people to see the content–but we like GitHub’s tools for commenting & collaboration, and the content is going to end up in markdown controlled by git…
So, not asking for advice, but asking what YOUR actual current practices are around getting reviews & sharing the comments for newer, longer pieces of content. For example, if this was a brand new file for your team:
https://developer.okta.com/docs/api/getting_started/api_test_client.html (it’s not new, just an example)