update comments

Author: leehuwuj

templates/types/streaming/nextjs/app/components/ui/chat/chat-message/markdown.tsx

@@ -122,7 +122,7 @@ export default function Markdown({
           );
         },
         a({ href, children }) {
-          // If href starts with http://localhost:8000/api/files, render DocumentPreview
+          // If href starts with `{backend}/api/files`, then it's a local document and we use DocumenInfo for rendering
           if (href?.startsWith(backend + "/api/files")) {
             return (
               <DocumentInfo

templates/types/streaming/nextjs/app/components/ui/chat/index.ts

@@ -23,16 +23,16 @@ export type DocumentFileType = "csv" | "pdf" | "txt" | "docx";
 
 export type UploadedFileMeta = {
   id: string;
-  name: string;
+  name: string; // The uploaded file name in the backend (including uuid and sanitized)
   url?: string;
   refs?: string[];
 };
 
 export type DocumentFile = {
-  filename: string;
+  filename: string; // The original file name
   filesize: number;
   filetype: DocumentFileType;
-  metadata?: UploadedFileMeta;
+  metadata?: UploadedFileMeta; // undefined when the file is not uploaded yet
 };
 
 export type DocumentFileData = {