I’ve been developing for atom for 3+ years now. The APIs are always changing as the team continues to grow the editor and that is great. The problem is there are aspects of atom that are important for non-core team members developing new things for the editor. The biggest gap in documentation I think has been with UI elements. Since the initial steps to deprecate space-pen, the official docs on atom.io/docs have not included anything about how to use UI elements.
I’ve been frustrated about this for a while and haven’t a chance or investment to bring this up but now I’m working on an atom package full time and feeling the pain even more.
I’d be happy to help start this if someone points me in the right direction.