src: add more checks and clarify docs for external references

src: add more checks and clarify docs for external references #72197