Apply suggestions from code review

Author: pawamoy

docs/usage/configuration/headings.md

@@ -62,10 +62,9 @@ plugins:
 - **:octicons-package-24: Type [`str`][] :material-equal: `""`{ title="default value" }**
 <!-- - **:octicons-project-template-24: Template :material-null:** (N/A) -->
 
-A custom string to use as the heading of the root of the object (i.e. the object specfied directly after the identifier `:::`). This will override the default heading generated by the plugin.
+A custom string to use as the heading of the root object (i.e. the object specified directly after the identifier `:::`). This will override the default heading generated by the plugin.
 
-!!! warning "Not advised to be used as a general configuration option"
-    This option is not advised to be used as a general configuration option, as it will override the default heading for all objects. It is recommended to use it only in specific cases where you want to override the heading for a specific object.
+WARNING: **Not advised to be used as a global configuration option.** This option is not advised to be used as a global configuration option, as it will override the default heading for all objects. It is recommended to use it only in specific cases where you want to override the heading for a specific object.
 
 ```md title="in docs/some_page.md (local configuration)"
 ::: path.to.module
@@ -80,11 +79,9 @@ A custom string to use as the heading of the root of the object (i.e. the object
 
 A custom string to use as the label in the Table of Contents for the root object (i.e. the one specified directly after the identifier `:::`). This will override the default label generated by the plugin.
 
-!!! warning "Not advised to be used as a general configuration option"
-    This option is not advised to be used as a general configuration option, as it will override the default label for all objects. It is recommended to use it only in specific cases where you want to override the label for a specific object.
+WARNING: **Not advised to be used as a global configuration option.** This option is not advised to be used as a global configuration option, as it will override the default label for all objects. It is recommended to use it only in specific cases where you want to override the label for a specific object.
 
-!!! note "Use with/without `heading`"
-    If you use this option without specifying a custom `heading`, the default heading will be used in the page, but the label in the Table of Contents will be the one you specified. By providing both an option for `heading` and `toc_label`, we leave the customization entirely up to you.
+NOTE: **Use with/without `heading`.** If you use this option without specifying a custom `heading`, the default heading will be used in the page, but the label in the Table of Contents will be the one you specified. By providing both an option for `heading` and `toc_label`, we leave the customization entirely up to you.
 
 ```md title="in docs/some_page.md (local configuration)"
 ::: path.to.module

src/mkdocstrings_handlers/python/handler.py

@@ -145,8 +145,8 @@ class PythonHandler(BaseHandler):
             The modules must be listed as an array of strings. Default: `None`.
 
     Attributes: Headings options:
-        heading (str): A custom string to override the autogenerated heading of the root object
-        toc_label (str): A custom string to override the autogenerated toc label of the root object
+        heading (str): A custom string to override the autogenerated heading of the root object.
+        toc_label (str): A custom string to override the autogenerated toc label of the root object.
         heading_level (int): The initial heading level to use. Default: `2`.
         parameter_headings (bool): Whether to render headings for parameters (therefore showing parameters in the ToC). Default: `False`.
         show_root_heading (bool): Show the heading of the object at the root of the documentation tree