The LLVM ecosystem is so large that every few years I discover something new in it that I never even heard about. And sometimes, those things are just files somewhere, or a new directory with a name that sounds reasonable but looking at the code, it could be multiple things.
It would be nice to have a simple README.md that Github shows nicely at the end of directories, as a helper (on browser, editor, command line) to get the gist of what that code is about.
I’m sure the people who care about that are on top of maintenance and all, but the short in-place document would help others that aren’t actively developing that part, even if they’re a bit repetitive (ex. a similar one to every target, etc).
While there are
README.txt files scattered around (and Github does show them on the web UI), some of them are so old that they are completely irrelevant by now.
Could I interest existing active developers to add/update their own bit to their own areas?
Could this be something for the developer policy (for new stuff at least)?
I imagine this would be even more helpful to new developers trying to make sense of the huge repository we work on, and hopefully lower the learning curve.