nsh manual rewrite in mandoc draft feedback requested style ideas etc

Hello folks,

I have been translating the txt of MANUAL of nsh port to mandoc there is quite
alot of features and syntax to document so I figured that before I
complete the first redraft(that is fit for human consumption) I would
get feedback on what I have done so far.

do you like the bullets are they too much
what I should do more of?
what i should do less of?

any advice comments would be appreciated before we push the diff into
ports / upstream nsh

Thanks
Tom Smyth.