improve lock documentation [references #56]