Docs feedback: Discussion API [commits]

On the Discussions API: Commits documentation the API URL is /commits/:commit_id. I am not sure if this legacy API code, but I was unable to find working values for :commit_id. Instead, I have been writing the API using /repository/commits/:sha as the path and that appears to be correctly posting the discussions. This section could use some updating or some clarification.