This is the place to provide feedback, comment, suggest, discuss, etc... it doesn't appear in the docs and is only for reviewers/contributors.
This is just like a scratchpad or a board or even a chatroom, just edit, add a comment, create a new section, whatever and commit and push you changes to this file (do approve and merge your own PRs, heck you don't even have to create a PR and can simply commit and push to the repo master)
[JNM] to feedback on this new version of the docs just add to this document and push your commit, you can make any changes/additions/etc... to the docs and merge that in and use this place to explain what you did.
[JNM] @Scott created a 'Core NATS'