more docs for explaining transitive option