I said this when I first started getting into electronics and I’ll say it again:

software libraries need something akin to Datasheets. A technical document which lists facts about the operating parameters and intended uses, meant for a technically-minded person to evaluate “is this suitable for my use case?” and “what all would be involved in integrating this into my product?”

in my experience too much of this material for software reads like marketing fluff, making empty promises about ease or scale or whatever without any context under which those promises apply

we talk about software “engineering” and this sort of technical document strikes me as fundamental to that practice