[releases/2.3] docs: Cherry-pick various doc updates (#1186)

* docs: Upgrade Sphinx and change copyright year to "2022-%Y" (#1118)

* service: Reformat pyproject.toml

* service: Upgrade to latest Sphinx

* service: Update poetry.lock

* service: Update copyright to reflect year first published

* service: Add a comment about Sphinx version

* docs: Add gRPC and protobuf hyperlinks

* service: Update poetry.lock

(cherry picked from commit 64174c6)

* docs: Remove Sphinx --keep-going option (#1126)

(cherry picked from commit 262ab18)

* docs: Remove tomlkit dependency (#1166)

* docs: Remove tomlkit dependency

* service: Update poetry.lock

(cherry picked from commit 15b1bb8)

Author: bkeryan

.github/workflows/check_nims.yml

@@ -76,7 +76,7 @@ jobs:
         run: |
           rm -rf docs
           mkdir -p docs   
-          poetry run sphinx-build _docs_source docs -b html -W --keep-going
+          poetry run sphinx-build _docs_source docs -b html -W
       - name: Revert docs
         run:  rm -rf docs
       - name: Generate gRPC stubs

CONTRIBUTING.md

@@ -166,7 +166,7 @@ The `ni_measurement_plugin_sdk_service` package uses Sphinx to build API
 reference documentation.
 
 ```cmd
-poetry run sphinx-build _docs_source docs -b html -W --keep-going
+poetry run sphinx-build _docs_source docs -b html -W
 ```
 
 The generated documentation is at `docs/index.html`.

packages/service/_docs_source/conf.py

@@ -1,6 +1,5 @@
 """Sphinx Configuration File."""
 
-import datetime
 import pathlib
 
 import autoapi.extension
@@ -27,8 +26,7 @@
 
 project = proj_config["tool"]["poetry"]["name"]
 company = "National Instruments"
-year = str(datetime.datetime.now().year)
-copyright = f"{year}, {company}"
+copyright = f"2022-%Y, {company}"
 
 
 # The version info for the project you're documenting, acts as replacement for
@@ -88,13 +86,15 @@ def setup(sphinx):
 
 
 intersphinx_mapping = {
+    "grpc": ("https://grpc.github.io/grpc/python/", None),
     "nidaqmx": ("https://nidaqmx-python.readthedocs.io/en/stable/", None),
     "nidcpower": ("https://nidcpower.readthedocs.io/en/stable/", None),
     "nidigital": ("https://nidigital.readthedocs.io/en/stable/", None),
     "nidmm": ("https://nidmm.readthedocs.io/en/stable/", None),
     "nifgen": ("https://nifgen.readthedocs.io/en/stable/", None),
     "niscope": ("https://niscope.readthedocs.io/en/stable/", None),
     "niswitch": ("https://niswitch.readthedocs.io/en/stable/", None),
+    "protobuf": ("https://googleapis.dev/python/protobuf/latest/", None),
     "python": ("https://docs.python.org/3", None),
 }