Adding naming documentation

[mohanad0mohamed]

Fixes #22

• Edited conf.py for configuration of colors

• Edited index.rst to include naming.rst

• Added naming.rst with info on naming convention.

• Added extra.css for coloring visuals

• Built locally with no errors

[mohanad0mohamed]

I have found that the last commit on main branch already contains symbolic link to open-source-pdks which contains naming.rst also. But still we will need the changes in:
conf.py
extra.css

[mohanad0mohamed]

naming.rst is removed and index.rst is the default with no edits.

[mithro]

We should move the extra.css and the python stuff in conf.py into https://github.com/google/open-source-pdks and then this repository should then just use the files from third_party/open-source-pdks like it does with the rst files.

[mohanad0mohamed]

I'm afraid that may not happen, at least for conf.py, as it's used by read-the-docs/sphinx to configure the docs build. The problem is each project may use options different than the other like color scheme, link to their repository, and extensions.
The extra.css can be moved no problems with it.

[atorkmabrains]

I approve this change per @mithro request to clean up the documentation.

[mithro]

I have rebased this change on top of the other work which has been merged. Will add a review shortly.

[mithro]

@mohanad0mohamed - I'm not sure the title of this pull request doesn't make sense any more?

[mithro]

Do you think my suggestions here make sense?

[mithro]

We should move this python code into a sphinx extension module.

We can then add the extension to the requirements.txt and the extension list found at https://github.com/google/gf180mcu-pdk/blob/main/docs/conf.py#L51-L62

We can probably store the extension in the repository at https://github.com/google/open-source-pdks

[mohanad0mohamed]

I have edit the required files to depend on open-source-pdks
This PR google/open-source-pdks#18 should be merged first to take effect.

[mithro]

This pull request looks really good!

Just one minor comment which is actually about google/open-source-pdks#18

[mithro]

We should give this extension a better name.

[mohanad0mohamed]

Fixed.

[mohanad0mohamed]

@mithro I have fixed the name as requested from ext.py to sphinx_pdk_roles.py