Required args' help entries should include "(required)" whether they are positional or not.  This is simply a coding convention, not something that is technically enforced.  I apologize for not having any developer docs yet.  :-\