docs(serializers): fix hyperlinks to salt.serializers

CHANGELOG.md

@@ -15,6 +15,7 @@ Versions are `MAJOR.PATCH`.
 ### Changed
 
 ### Fixed
+- [#56325](https://github.com/saltstack/salt/pull/56325) - Fix hyperlinks to `salt.serializers` and other documentation issues - [@myii](https://github.com/myii)
 
 ### Added
 

doc/topics/development/contributing.rst

@@ -139,7 +139,7 @@ Fork a Repo Guide_>`_ and is well worth reading.
 
     GOOD
 
-    .. code-block::
+    .. code-block:: bash
 
         Fix broken things in file1 and file2
 
@@ -157,7 +157,7 @@ Fork a Repo Guide_>`_ and is well worth reading.
 
     BAD
 
-    .. code-block::
+    .. code-block:: bash
 
         Fixes broken things
 

doc/topics/development/conventions/documentation.rst

@@ -306,7 +306,7 @@ Documentation Changes and Fixes
 Documentation changes and fixes should be made against the earliest supported
 release branch that the update applies to. The practice of updating a release
 branch instead of making all documentation changes against Salt's main, default
-branch, ``develop``, is necessary in order for the docs to be as up-to-date as
+branch, ``master``, is necessary in order for the docs to be as up-to-date as
 possible when the docs are built.
 
 The workflow mentioned above is also in line with the recommendations outlined

doc/topics/releases/3000.rst

@@ -555,7 +555,7 @@ the ``engine_module`` parameter in the engine configuration.
           host: localhost
           port: 24224
 
-  .. code-block::
+  .. code-block:: none
 
     <source>
       @type forward

salt/modules/slsutil.py

@@ -203,8 +203,8 @@ def _get_serialize_fn(serializer, fn_name):
 
 def serialize(serializer, obj, **mod_kwargs):
     '''
-    Serialize a Python object using a :py:mod:`serializer module
-    <salt.serializers>`
+    Serialize a Python object using one of the available
+    :ref:`all-salt.serializers`.
 
     CLI Example:
 
@@ -225,8 +225,8 @@ def serialize(serializer, obj, **mod_kwargs):
 
 def deserialize(serializer, stream_or_string, **mod_kwargs):
     '''
-    Deserialize a Python object using a :py:mod:`serializer module
-    <salt.serializers>`
+    Deserialize a Python object using one of the available
+    :ref:`all-salt.serializers`.
 
     CLI Example:
 

salt/states/file.py

@@ -6873,8 +6873,8 @@ def serialize(name,
         .. versionadded:: 2015.8.0
 
     formatter
-        Write the data as this format. See the list of :py:mod:`serializer
-        modules <salt.serializers>` for supported output formats.
+        Write the data as this format. See the list of
+        :ref:`all-salt.serializers` for supported output formats.
 
     encoding
         If specified, then the specified encoding will be used. Otherwise, the