I would like to be able to add documentation to my Python Toolboxes inside of the pyt file instead of creating the documentation through ArcGIS Desktop "Item Description" process (which generates XML files).
Using the existing method, sometimes if I add a parameter to a Python Toolbox tool, the XML files will be regenerated and I have to redo all of the documentation from scratch. Not cool.