docs: sync 46 hand-written docs with actual implementation (reader-facing audit)

docs: sync 46 hand-written docs with actual implementation (reader-facing audit) #4146