doc: comments

src/utils/misc.py

@@ -32,6 +32,8 @@ def get_posts() -> list[str]:
 
 
 class File:
+    """file representation"""
+
     def __init__(self, content: str, cdate: str):
         # content
         self.content = content
@@ -77,6 +79,7 @@ def fresh_file_id() -> int:
 
 
 def exist_post(file_id: int) -> float | None:
+    """check if post exists, return modification epoch"""
     try:
         return os_path.getmtime(post_filename(file_id))
     except FileNotFoundError: