[Documentation][system] Standarize docstrings in module_utils/system.py (#1363)

* Modify google style to numpy

* Add changelog fragment

* Standarize numpy style

* Standarize numpy style

* Added year

* Update 1363-update-docstring-system.yml

---------

Co-authored-by: Fernando Flores <[email protected]>

Author: IsaacVRey

changelogs/fragments/1363-update-docstring-system.yml

@@ -0,0 +1,3 @@
+trivial:
+  - system - Updated docstrings to numpy style for visual aid to developers.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/1363).

plugins/module_utils/system.py

@@ -1,4 +1,4 @@
-# Copyright (c) IBM Corporation 2020, 2023
+# Copyright (c) IBM Corporation 2020, 2024
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -34,19 +34,23 @@
 
 
 def is_posix():
-    """ Determine if the system is POSIX certified or compliant
+    """Determine if the system is POSIX certified or compliant.
 
-    Returns:
-        bool -- Whether the system is POSIX
+    Returns
+    -------
+    bool
+        Whether the system is POSIX.
     """
     return OS_NAME == "posix"
 
 
 def is_nix():
-    """ Determine if the system is a variant of Unix, supported by Python.
+    """Determine if the system is a variant of Unix, supported by Python.
 
-    Returns:
-        bool -- Whether the system is Unix-based
+    Returns
+    -------
+    bool
+        Whether the system is Unix-based.
     """
     if not is_posix():
         return False
@@ -58,19 +62,23 @@ def is_nix():
 
 
 def is_win():
-    """ Determine if the system is a Windows platform
+    """Determine if the system is a Windows platform.
 
-    Returns:
-        bool -- Whether the system is Windows
+    Returns
+    -------
+    bool
+        Whether the system is Windows.
     """
     return "win32" in platform().lower() or OS_NAME == "nt"
 
 
 def is_zos():
-    """ Determine if the system is a z/OS distribution
+    """Determine if the system is a z/OS distribution.
 
-    Returns:
-        bool -- Whether the system is z/OS
+    Returns
+    -------
+    bool
+        Whether the system is z/OS.
     """
     is_zos_unix = is_posix() and not is_nix()
     return is_zos_unix and SYS_PLATFORM == "zos"