README and adaptor flexibility