duplex: docs, tests, examples