update docs with new url based includes behaviour