@witty-crayon-22786: Regarding putting decorators on everything: I don't like it for the same reasons @rough-minister-58256 mentions - it impacts the runtime performance. My first suggestion was to use docstrings, which sounds somewhat similar to what you want the end goals to be. I'm personally OK with minimizing the scope of the API refactoring and with leaving a lot as 'public', and minimizing the amount we privatize, (although that might mean we will limit the changes we will allow ourselves to make as a part of a stable 1.0 release.)