Documentation Question re: "Building help for your admin plugin"

Zen cart 1.5.7 on:
A couple of questions re documentation page Technical - Building help for your admin plugin

Is it preferred to have the help pages included with the add-on or is acceptable to link out to Git Hub and use MD?
If it is preferred to keep help with the add-on. Would it be a good idea to have a standard directory e.g YOURSTORE/help?
I think this would make it easier to find and also if using encapsulated plug in, in a standard place?

Another thought would be to allow MD to be added to the zen-cart documentation. This may be a step to far! One advantage would be consistent style.
one disadvantage would be control.

By the way what does zen-cart use to render the MD pages in the documentation section - is it in zen-cart?

Bear in mind that sometimes what you're reading in the help (and in this case, this article does) pertains to the next version of Zen Cart. You are on the cutting edge!

Answers to questions:

• Please bundle help in with contributions if you're building a contribution. The information you are reading is if you're building something for your store or a client store.
• We haven't done anything with help and encapsulated plugins yet.
• Zen Cart uses Hugo to build its documentation. See https://gohugo.io/

Thanks that's great. Yes I realise it is at the cutting edge. Just wanted to make sure I did not go off in the wrong direction