Fixing docs warnings

[mohanad0mohamed]

Fixes #20

• All warnings have been fixed and tested locally.
• It seems like there are some edits to be able to be merged with main.

[mohanad0mohamed]

Before merging this pull request, These pull requests google/globalfoundries-pdk-ip-gf180mcu_fd_ip_sram#5 and google/globalfoundries-pdk-libs-gf180mcu_fd_io#2 should be merged first to solve 7 warnings found in this build https://gf180mcu-pdk--35.org.readthedocs.build/en/35/

[atorkmabrains]

I approve this change per @mithro request the files has been moved to a different location.

[mithro]

This change will need to be rebased onto the latest changes which have been merged.

[mithro]

You should add fail_on_warning: true flag back to the .readthedocs.yml file since I ended up removing that from #31 (comment)

[mithro]

Why is this extension disabled? I think we want to make sure that every section has a label?

[mohanad0mohamed]

Because it introduces warnings on duplicate labels. I have added suppressor instead.

[mithro]

I don't think this remove is needed any more?

[mohanad0mohamed]

Duplicate thus produce warning.

[mohanad0mohamed]

This PR should be merged after all these:

• Fixing warnings open-source-pdks#18
• Adding naming documentation #39
• Fixing warnings globalfoundries-pdk-ip-gf180mcu_fd_ip_sram#8
• Fixing warnings globalfoundries-pdk-libs-gf180mcu_fd_io#4
• Fixing warnings globalfoundries-pdk-libs-gf180mcu_fd_sc_mcu7t5v0#8
• Fixing warnings globalfoundries-pdk-libs-gf180mcu_fd_sc_mcu9t5v0#11

[mohanad0mohamed]

Renamed the extension of role as in google/open-source-pdks#18

[mohanad0mohamed]

Latest update: this PR should be merged after all these:

• Fixing warnings open-source-pdks#18
• Adding naming documentation #39
• Fixing warnings globalfoundries-pdk-libs-gf180mcu_fd_sc_mcu7t5v0#8
• Fixing warnings globalfoundries-pdk-libs-gf180mcu_fd_sc_mcu9t5v0#11
• Fix broken standard cell schematic images globalfoundries-pdk-libs-gf180mcu_fd_sc_mcu7t5v0#9
• FIx schematics images globalfoundries-pdk-libs-gf180mcu_fd_sc_mcu9t5v0#12

[mohanad0mohamed]

Added exclusion of code-of-conduct.rst and contributing.rst in conf.py

[mithro]

Change looks pretty good?

Bunch of things;

• I think this needs the same changes as found in docs: Make config version 2. open-source-pdks#22
• Can you rebase this change?
• Why did you change the symlink to not include the docs directory?

[mithro]

The docs build is also failing with

Running Sphinx v5.1.1
fatal: --unshallow on a complete repository does not make sense

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/gf180mcu-pdk/envs/35/lib/python3.7/site-packages/sphinx/registry.py", line 442, in load_extension
    mod = import_module(extname)
  File "/home/docs/checkouts/readthedocs.org/user_builds/gf180mcu-pdk/envs/35/lib/python3.7/importlib/__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1006, in _gcd_import
  File "<frozen importlib._bootstrap>", line 983, in _find_and_load
  File "<frozen importlib._bootstrap>", line 965, in _find_and_load_unlocked
ModuleNotFoundError: No module named 'sphinx_pdk_roles'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/gf180mcu-pdk/envs/35/lib/python3.7/site-packages/sphinx/cmd/build.py", line 276, in build_main
    args.pdb)
  File "/home/docs/checkouts/readthedocs.org/user_builds/gf180mcu-pdk/envs/35/lib/python3.7/site-packages/sphinx/application.py", line 222, in __init__
    self.setup_extension(extension)
  File "/home/docs/checkouts/readthedocs.org/user_builds/gf180mcu-pdk/envs/35/lib/python3.7/site-packages/sphinx/application.py", line 400, in setup_extension
    self.registry.load_extension(self, extname)
  File "/home/docs/checkouts/readthedocs.org/user_builds/gf180mcu-pdk/envs/35/lib/python3.7/site-packages/sphinx/registry.py", line 446, in load_extension
    err) from err
sphinx.errors.ExtensionError: Could not import extension sphinx_pdk_roles (exception: No module named 'sphinx_pdk_roles')

Extension error:
Could not import extension sphinx_pdk_roles (exception: No module named 'sphinx_pdk_roles')
Docs dir is: /home/docs/checkouts/readthedocs.org/user_builds/gf180mcu-pdk/checkouts/35/docs

[mithro]

Can you just drop the IPs bit? IE Just **/code-of-conduct.rst?