Add spelling check in the web docs

Author: luszczewskakasia1

.github/workflows/reusable_checks.yml

@@ -21,14 +21,15 @@ jobs:
     - name: Install dependencies
       run: |
         sudo apt-get update
-        sudo apt-get install -y black cmake clang-format-15 cmake-format libhwloc-dev
+        sudo apt-get install -y black cmake clang-format-15 cmake-format libhwloc-dev doxygen
 
     # Latest distros do not allow global pip installation
     - name: Install Python requirements in venv
       run: |
         python3 -m venv .venv
         . .venv/bin/activate
         echo "$PATH" >> $GITHUB_PATH
+        python3 -m pip install -r third_party/requirements.txt
         python3 -m pip install bandit codespell
 
     - name: Configure CMake
@@ -64,6 +65,12 @@ jobs:
     - name: Run codespell
       run: python3 ./.github/scripts/run-codespell.py
 
+    - name: Check spelling in docs
+      run: |
+        cmake -B build
+        cmake --build build --target docs
+        sphinx-build -b spelling ./build/docs_build/config ./build/docs_build/spelling_log -W
+
     # Run Bandit recursively, but omit _deps directory (with 3rd party code) and python's venv
     - name: Run Bandit
       run: python3 -m bandit -r . -x '/_deps/,/.venv/'

docs/config/Doxyfile

@@ -445,7 +445,7 @@ INLINE_SIMPLE_STRUCTS  = NO
 # types are typedef'ed and only the typedef is referenced, never the tag name.
 # The default value is: NO.
 
-TYPEDEF_HIDES_STRUCT   = NO
+TYPEDEF_HIDES_STRUCT   = YES
 
 # The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
 # cache is used to resolve symbols given their name and scope. Since this can be

docs/config/conf.py

@@ -36,7 +36,10 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["breathe"]
+extensions = ["breathe", "sphinxcontrib.spelling"]
+
+spelling_show_suggestions = True
+spelling_word_list_filename = "spelling_exceptions.txt"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

docs/config/spelling_exceptions.txt

@@ -0,0 +1,74 @@
+addr
+allocatable
+allocator
+allocators
+calloc
+CXL
+copyable
+customizable
+daxX
+deallocation
+deallocating
+deallocations
+Devdax
+dev
+Globals
+hMemtarget
+hPool
+hProvider
+highPtr
+io
+interprocess
+ipc
+jemalloc
+lowPtr
+malloc
+maxnode
+mem
+mempolicies
+mempolicy
+Mempolicy
+memspace
+Memspace
+memspaces
+Memtarget
+memtarget
+memtargets
+middleware
+multithreading
+Nodemask
+nodemask
+numa
+oneAPI
+oneTBB
+os
+params
+partList
+pid
+poolable
+preallocated
+providerIpcData
+providential
+ptr
+realloc
+Scalable
+scalable
+stdout
+Tiering
+tiering
+topologies
+umf
+umfGetIPCHandle
+umfMemoryProviderAlloc
+umfMemoryProviderGetLastNativeError
+umfMemoryProviderOpenIPCHandle
+umfOsMemoryProviderParamsDestroy
+umfPool
+umfPoolCalloc
+umfPoolDestroy
+umfPoolGetTag
+umfPoolMallocUsableSize
+umfPoolRealloc
+umfMemspaceUserFilter
+umfMemspaceMemtargetAdd
+unfreed

scripts/check_license/file-exceptions.sh

@@ -9,6 +9,7 @@ grep -v -E -e 'benchmark/ubench.h' \
            -e 'ChangeLog' \
            -e 'CODEOWNERS$' \
            -e 'docs/assets/.*' \
+           -e 'docs/config/spelling_exceptions.txt' \
            -e 'docs/config/conf.py' \
            -e 'docs/config/Doxyfile' \
            -e 'include/umf/proxy_lib_new_delete.h' \

third_party/requirements.txt

@@ -15,3 +15,6 @@ sphinxcontrib_qthelp==2.0.0
 breathe==4.35.0
 sphinx==8.1.3
 sphinx_book_theme==1.1.3
+# Spelling check in documentation
+pyenchant==3.2.2
+sphinxcontrib-spelling==8.0.0