style multiline doc strings
document the order of operations

github issue #36