homepage

While we are talking the Action class, the documentation isn't clear that the 'add_argument' method returns an Action object, specifically one the subclasses. More than once, when answering Stackoverflow questions I've recommended assigning this object to a variable for use later in the script. 
 a = parser.add_argument(...)
 ...
 print a.dest
 a.help = 'change the help'
 a.required = True
 ...
The doc mentions that 'add_subparsers' 'returns a special action object.'
In sum, I think the documentation needs a sentence or two that describe what add_argument returns. I'm less sure whether it should include an example of using that return.