add docs for #17