document intended usage