I’m sympathetic to the idea that people sometimes approach open-source projects with a strange sense of entitlement, of give me this and give me that…
I was especially annoyed with the docs because of the lack of even a parenthetical (ctrl/cmd), which is almost idiomatic at this point. As far as contributing to the docs, I’m happy to (I’m also in the process of re-writing Google’s Protocol Buffers intro, on my own, for the benefit of humanity, which I’ll probably trot out as an example of unclear/clear explanation of a new technology.) There might need to be separate forks for Mac, Windows, and Linux instructions. I can imagine three tabs on top where people just click on their OS. Or not – maybe it’s easy to do with sprinkles of clarification and parenthethicals here and there.
Almost all the current docs are aimed at developers who want to write a theme or package. The concept of a user in the normal sense is virtually absent, as is the concept of a Windows user. This might just be what Atom is and what Atom wants to be.
More reflectively, I’m surprised at how pervasive the Mac assumption is in numerous open-source dev tool projects. This must reflect some kind of demographic reality, or skew in who is creating these sorts of projects, who they’re creating them for, etc. From a technical standpoint, I’m bummed at how rare it is to see anyone really take advantage of the Windows platform, to dig into the architecture, libraries, etc. and build high-quality and superfast native apps. The Windows versions of tools like GitHub and Atom seem to be second-class, or after-the-Mac-release situations. Maybe this is Microsoft’s fault. I think they should consider some kind of Reference Apps program to demonstrate what you can do in modern Windows if you really focus and dig in. In Atom’s case, I think it would be interesting to see a typographically aware text editor. The terminal look is standard with text editors and kind of cool, but I wonder what perfectly crisp text in a paper-like environment would feel like – maybe that’s themable, but to really get there in Windows you need to go with DirectWrite, a subset of Direct2D and DirectX. There’s something like this on the Mac. I don’t remember what tools Atom uses, but this might be possible in QT now. A topic for another thread I suppose.