Update documentation for automatic spellcheck (#5105)

* docs: initial update

* docs: update-environment-hooks

* chore: lint fixes

* chore: update doc as per PR comments

* chore: update PR review comments

* chore: update gitignore

* docs: update docs for automatic spellcheck

* chore: update as per PR comments

* chore: update as per PR comments

---------

Co-authored-by: SuperGops7 <[email protected]>

Author: SuperGops7

.gitignore

@@ -3,3 +3,4 @@ _build/
 .idea/
 .vscode/
 __pycache__
+ros2doc/

README.md

@@ -58,7 +58,8 @@ To check the spelling, use:
 `make spellcheck`
 
 > [!NOTE]
-> If that detects specific words that need to be ignored, add it to [codespell_whitelist](./codespell_whitelist.txt).
+> If that detects specific words that need to be ignored, add it to [codespell_whitelist](./codespell_whitelist.txt). \
+> To include any custom corrections that are to be applied, add it to [codespell_dictionary](./codespell_dictionary.txt).
 
 ### Deployment test
 

source/The-ROS2-Project/Contributing/Contributing-To-ROS-2-Documentation.rst

@@ -122,6 +122,7 @@ You can run the documentation spell checker locally (using `codespell <https://g
 
    If that detects specific words that need to be ignored, add it to `codespell_whitelist <https://github.com/ros2/ros2_documentation/blob/{REPOS_FILE_BRANCH}/codespell_whitelist.txt>`_ .
 
+To know more about spelling checks, refer to :ref:`Spelling check <spelling-check>`
 
 View Site Through Github CI
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -164,6 +165,34 @@ To check for broken links on the site, run:
 
 This will check the entire site for broken links, and output the results to the screen and ``build/linkcheck``.
 
+.. _spelling-check:
+
+Spelling check
+^^^^^^^^^^^^^^
+
+The ``make spellcheck`` command scans the documentation files and flags any misspellings.
+If errors are detected, review the suggestions and update the pull request as necessary.
+
+Some words, such as technical terms or proper nouns, maybe mistakenly flagged as misspelled.
+If you encounter such instances, you can add them to the ignore list to prevent them from being flagged in the future.
+To do this, add it to the `codespell_whitelist <https://github.com/ros2/ros2_documentation/blob/{REPOS_FILE_BRANCH}/codespell_whitelist.txt>`_ file as follows:
+
+.. code-block:: text
+
+   empy
+   ws
+   lets
+   jupyter
+
+To include custom corrections that ``codespell`` should apply, you can add them to the `codespell_dictionary <https://github.com/ros2/ros2_documentation/blob/{REPOS_FILE_BRANCH}/codespell_dictionary.txt>`_ file as follows:
+
+.. code-block:: text
+
+   amnet->ament
+   colcn->colcon
+   rosabg->rosbag
+   rosdistroy->rosdistro
+
 Migrating Pages from the ROS Wiki
 ---------------------------------