Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>

Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>

Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>

…b.com/melechlapson/qiskit into mlapson/switch-to-sphinx-ext-linkcode

Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>

Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>

Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>

We got this stacktrace:

Traceback (most recent call last):
  File "/home/vsts/work/1/s/.tox/docs/lib/python3.8/site-packages/sphinx/events.py", line 96, in emit
    results.append(listener.handler(self.app, *args))
  File "/home/vsts/work/1/s/.tox/docs/lib/python3.8/site-packages/sphinx/ext/linkcode.py", line 55, in doctree_read
    uri = resolve_target(domain, info)
  File "/home/vsts/work/1/s/docs/conf.py", line 216, in linkcode_resolve
    file_name = PurePath(full_file_name).relative_to(repo_root)
  File "/opt/hostedtoolcache/Python/3.8.18/x64/lib/python3.8/pathlib.py", line 908, in relative_to
    raise ValueError("{!r} does not start with {!r}"
ValueError: '/opt/hostedtoolcache/Python/3.8.18/x64/lib/python3.8/contextlib.py' does not start with '/home/vsts/work/1/s'

We shouldn't even attempt to generate a link for the file contextlib.py

New build failed with this stacktrace:
Traceback (most recent call last):
  File "/home/vsts/work/1/s/.tox/docs/lib/python3.8/site-packages/sphinx/events.py", line 96, in emit
    results.append(listener.handler(self.app, *args))
  File "/home/vsts/work/1/s/.tox/docs/lib/python3.8/site-packages/sphinx/ext/linkcode.py", line 55, in doctree_read
    uri = resolve_target(domain, info)
  File "/home/vsts/work/1/s/docs/conf.py", line 215, in linkcode_resolve
    full_file_name = inspect.getsourcefile(obj)
  File "/opt/hostedtoolcache/Python/3.8.18/x64/lib/python3.8/inspect.py", line 696, in getsourcefile
    filename = getfile(object)
  File "/opt/hostedtoolcache/Python/3.8.18/x64/lib/python3.8/inspect.py", line 665, in getfile
    raise TypeError('{!r} is a built-in class'.format(object))
TypeError: <class 'builtins.CustomClassical'> is a built-in class

So I added a condition that the obj should not be a built-in

…b.com/melechlapson/qiskit into mlapson/switch-to-sphinx-ext-linkcode

…itch-to-sphinx-ext-linkcode

…lechlapson/qiskit into mlapson/switch-to-sphinx-ext-linkcode

Co-authored-by: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>

…itch-to-sphinx-ext-linkcode

1. Remove misleading PR conditional. This worfklow doesn't even run in PRs. It was bad copy-pasta from the runtime repo
2. Clarify why we point tag builds to their stable branch name