one thing that might confuse   dumb   people like me is that here we are talking about deprecation from a deployer perspective  as we will migrate the same api over to the new repo and it will be consumed in the same way  so perhaps make this   dumb   proof by stating specifically what you will deprecate