I really appreciate it when library developers specify upfront in the documentation what their design goals and non-goals are.

Even when they don't match what I'm looking for, it immediately tells me whether it's what I need, and saves me a lot of time and frustration!