#129: docs explained