Fix comments and docstrings

Author: r4victor

src/dstack/_internal/server/security/permissions.py

@@ -101,9 +101,10 @@ async def __call__(
 
 class ProjectMemberOrPublicAccess:
     """
-    Allows access to project details for:
-    1. Project members (existing behavior)
-    2. Any authenticated user if the project is public
+    Allows access to project for:
+    - Global admins
+    - Project members
+    - Any authenticated user if the project is public
     """
 
     async def __call__(
@@ -121,20 +122,16 @@ async def __call__(
         if project is None:
             raise error_not_found()
 
-        # Global admins always have access
         if user.global_role == GlobalRole.ADMIN:
             return user, project
 
-        # Check if user is a project member
         project_role = get_user_project_role(user=user, project=project)
         if project_role is not None:
             return user, project
 
-        # If not a member, check if project is public
         if project.is_public:
             return user, project
 
-        # Neither member nor public project
         raise error_forbidden()
 
 

src/dstack/_internal/server/services/projects.py

@@ -55,7 +55,6 @@ async def list_user_projects(
 ) -> List[Project]:
     """
     Returns projects where the user is a member.
-    For backward compatibility - use list_user_accessible_projects for public project discovery.
     """
     if user.global_role == GlobalRole.ADMIN:
         projects = await list_project_models(session=session)
@@ -82,7 +81,7 @@ async def list_user_accessible_projects(
         projects = await list_project_models(session=session)
     else:
         member_projects = await list_user_project_models(session=session, user=user)
-        public_projects = await _list_public_non_member_project_models(session=session, user=user)
+        public_projects = await list_public_non_member_project_models(session=session, user=user)
         projects = member_projects + public_projects
 
     projects = sorted(projects, key=lambda p: p.created_at)
@@ -264,15 +263,7 @@ async def list_user_project_models(
     include_members: bool = False,
 ) -> List[ProjectModel]:
     """
-    Get projects for a user where they are a member.
-
-    Args:
-        session: Database session
-        user: User model
-        include_members: Whether to join and load project members
-
-    Returns:
-        List of ProjectModel instances where user is a member
+    List project models for a user where they are a member.
     """
     options = []
     if include_members:
@@ -289,12 +280,12 @@ async def list_user_project_models(
     return list(res.scalars().unique().all())
 
 
-async def _list_public_non_member_project_models(
+async def list_public_non_member_project_models(
     session: AsyncSession,
     user: UserModel,
 ) -> List[ProjectModel]:
     """
-    Get public projects where user is NOT a member.
+    List public project models where user is NOT a member.
     """
     res = await session.execute(
         select(ProjectModel).where(