update the docs on runnable (incomplete)