Merge branch 'feature/documentation' into 'develop'

Feature/documentation

See merge request 2020-2021/online/s101/group-02/access_controller!49

main/views.py

@@ -232,7 +232,10 @@ def work_become_engineer(request: WSGIRequest) -> HttpResponseRedirect:
     return HttpResponseRedirect(reverse('work', args=(request.user.id,)))
 
 
-def main_page(request):
+def main_page(request: WSGIRequest) -> HttpResponse:
+    """
+    Функция переадресации на главную страницу.
+    """
     return render(request, 'pages/index.html')
 
 
@@ -281,6 +284,12 @@ class AdminPageView(LoginRequiredMixin, PermissionRequiredMixin,SuccessMessageMi
             log(user, self.request.user.userprofile)
 
     def make_light_agents(self, users):
+        """
+        Функция проходит по списку пользователей, проставляя статус "light agent".
+
+        :param users: Список пользователей
+        :return: Обновленный список пользователей
+        """
         for user in users:
             make_light_agent(user, self.request.user)
             log(user, self.request.user.userprofile)