`.rst` is used for end-user docs, and `.md` is for developers. This came up in https://github.com/envoyproxy/nighthawk/pull/238#discussion_r360203420
.rstis used for end-user docs, and.mdis for developers. This came up in #238 (comment)