Refactor: update docstrings for 1/2 tasks

src/Lesson_4/practice_1.py

@@ -1,10 +1,16 @@
 class Employee:
-    """Сотрудник Великой Компании"""
+    """
+    Сотрудник Великой Организации
+
+    Attrs:
+        has_2_hands (bool): качественно ли выполняет работу
+        expirience (int): опыт работы в компании (в годах)
+    """
 
     def __init__(self, has_2_hands: bool, expirience: int):
         """Инициализация сотрудника
 
-        args:
+        Args:
             has_2_hands (bool): качественно ли выполняет работу
             expirience (int): опыт работы в компании (в годах)
         """
@@ -25,9 +31,13 @@ class Employee:
 
 
 class Manager(Employee):
-    """Менеджер Великой Компании
-
+    """
+    Менеджер Великой Компании
     Наследование от класса Employee
+
+    Attrs:
+        has_2_hands (bool): качественно ли выполняет работу
+        expirience (int): опыт работы в компании (в годах)
     """
 
     def __init__(self, has_2_hands: bool, expirience: int):
@@ -50,9 +60,15 @@ class Manager(Employee):
 
 
 class Developer(Employee):
-    """Разработчик Великой Компании
-
+    """
+    Разработчик Великой Компании
     Наследование от класса Employee
+
+    Attrs:
+        has_2_hands (bool): качественно ли выполняет работу
+        expirience (int): опыт работы в компании (в годах)
+        love_python (bool, optional): нравится ли python.
+        по умолчанию False
     """
 
     def __init__(

src/Lesson_4/practice_2.py

@@ -1,5 +1,11 @@
 class Transport:
-    """Родительский класс для видов транспорта"""
+    """
+    Родительский класс для видов транспорта
+
+    Attrs:
+        weight (int): вес транспорта
+        name (str): название транспорта
+    """
 
     def __init__(self, weight: int, name: str):
         """Инициализация транспорта
@@ -21,8 +27,14 @@ class Transport:
 
 
 class Car(Transport):
-    """Класс для объектов типа Машина.
+    """
+    Класс для объектов типа Машина.
     Наследован от Transport.
+
+    Attrs:
+        weight (int): вес машины.
+        name (str): марка машины.
+        price (int): цена машины.
     """
 
     def __init__(self, weight: int, name: str, price: int):
@@ -46,8 +58,14 @@ class Car(Transport):
 
 
 class Skate(Transport):
-    """Класс для объектов типа Skate.
+    """
+    Класс для объектов типа Skate.
     Наследован от Transport.
+
+    Attrs:
+        weight (int): вес скейта.
+        name (str): название скейта.
+        price (int): цена скейта.
     """
 
     def __init__(self, weight: int, name: str, price: int):
@@ -71,8 +89,14 @@ class Skate(Transport):
 
 
 class Chair(Transport):
-    """Класс для объектов типа Chair.
+    """
+    Класс для объектов типа Chair.
     Наследован от Transport.
+
+    Attrs:
+        weight (int): вес кресла.
+        name (str): название кресла.
+        price (int): цена кресла.
     """
 
     def __init__(self, weight: int, name: str, price: int):