For me saying what a function does isn't good enough, when one is documenting an api. Examples are a must. The other problem is that the lisp packaging system is a bit weird. If a library doesn't have an ASDF definition its almost non-existent for me.