diff --git a/AI-MAP.md b/AI-MAP.md index f6ff45f68..ce0d37142 100644 --- a/AI-MAP.md +++ b/AI-MAP.md @@ -78,7 +78,7 @@ - `docs/monitoring.md` — **Smart Observability v7 – Predictive Health & Adaptive Feedback**: חיבור Grafana לטלגרם דרך Webhook, אנוטציות, ספים דינמיים, הפרדה בין שגיאות פנימיות לחיצוניות, ו-Predictive Health. - `docs/git-lfs.rst` — **Git LFS Integration**: להסביר מתי ואיך להשתמש ב‑Git Large File Storage (LFS) עבור קבצים גדולים. - `docs/user/bookmarks.rst` — **סימניות (Bookmarks)**: סימניות בקבצים: איך מוסיפים, פאנל הסימניות, העוגן היציב שמחזיק אותן גם כשהקוד זז, ומגבלות הפרטיות והאבטחה. -- `docs/user/sticky_notes.rst` — **פתקים דביקים (Sticky Notes)**: הצמדת הערות קצרות על תצוגת קובץ (קוד/Markdown/HTML): הוספה וניהול, עיגון יציב לעומת מיקום קבוע, השילוב עם סימניות, ומגבלות הפרטיות והאבטחה. +- `docs/user/sticky_notes.rst` — **פתקים דביקים (Sticky Notes)**: הצמדת הערות קצרות על תצוגת קובץ (Markdown): הוספה וניהול, עיגון יציב לעומת מיקום קבוע, השילוב עם סימניות. - `docs/user/reminders.rst` — **תזכורות בבוט**: מערכת התזכורות מאפשרת למשתמשי הבוט ליצור, לדחות ולנהל תזכורות אישיות דרך שיחה אינטראקטיבית או פקודות קצרות. המידע נשמר ב-MongoDB (`reminders/database.py`) ומנוהל דרך ישויות `Reminder` ו-`ReminderConfig`. - `docs/user/my_collections.rst` — **האוספים שלי (My Collections)**: אוספים מאפשרים לאגד יחד קבצים/קטעי קוד/סימניות תחת נושא משותף (פרויקט, משימה, מודול), כדי לשתף, לנווט ולעקוב בקלות. כל אוסף כולל שם, תיאור קצר ורשימת פריטים עם סדר מותאם. - `docs/user/share_code.rst` — **שיתוף קוד (חשוב)**: כפתור "🔗 שתף קוד" יוצר שיתוף מהיר של קובץ דרך GitHub Gist או Pastebin. הכפתור נושא את ה-ObjectId של הגרסה שהייתה קיימת כשהוא נוצר, ולכן הוא מצמיד גרסה ואינו מבטיח את התוכן העדכני. diff --git a/docs/user/sticky_notes.rst b/docs/user/sticky_notes.rst index 15de01c55..1d537d54a 100644 --- a/docs/user/sticky_notes.rst +++ b/docs/user/sticky_notes.rst @@ -1,12 +1,11 @@ פתקים דביקים (Sticky Notes) ============================= -:summary: הצמדת הערות קצרות על תצוגת קובץ (קוד/Markdown/HTML): הוספה וניהול, עיגון יציב לעומת מיקום קבוע, השילוב עם סימניות, ומגבלות הפרטיות והאבטחה. +:summary: הצמדת הערות קצרות על תצוגת קובץ (Markdown): הוספה וניהול, עיגון יציב לעומת מיקום קבוע, השילוב עם סימניות. מהם פתקים דביקים? ------------------- -פתקים דביקים מאפשרים להצמיד הערות קצרות ומודגשות על‑גבי תצוגת קובץ (קוד/Markdown/HTML), +פתקים דביקים מאפשרים להצמיד פתקים עם הערות על גביהם על‑גבי תצוגת קובץ (Markdown), כך שאפשר לסמן נקודות חשובות, משימות או תזכורות ישירות במקום הרלוונטי בתוכן. -הפתק "ננעל" לעוגן יציב כאשר ניתן (כותרת ב‑Markdown או ``id`` ב‑HTML) או לחלופין למיקום קואורדינטות/שורה בקוד. איך מוסיפים ומנהלים פתקים --------------------------- @@ -21,9 +20,9 @@ * - הוספת פתק - לחיצה על כפתור הפתקים בתצוגת הקובץ ואז לחיצה בנקודה הרצויה - מומלץ להצמיד לעוגנים יציבים (כותרת/``id``) כשאפשר, לשמירה לאחר עריכות - * - עריכת תוכן/צבע - - קליק על פתק קיים ועריכת השדה/בחירת צבע מהתפריט - - צבעים עוזרים לסיווג מהיר (למשל ירוק=בוצע, אדום=דחוף) + * - עריכת תוכן + - קליק על פתק קיים ועריכת השדה + - התוכן מוגבל ל‑5,000 תווים; אין בחירת צבע בממשק והפתק צהוב אחיד * - הזזה/מיקום מחדש - גרירה קצרה של הפתק למיקום חדש בתצוגה - אם הפתק מעוגן לעוגן יציב – ההצמדה תישמר, והמיקום החזותי יעדכן @@ -33,8 +32,7 @@ עיגון יציב לעומת מיקום קבוע ----------------------------- -- עיגון יציב: אם יש כותרת Markdown או אלמנט HTML עם ``id`` – הפתק נצמד לעוגן וכך נשמר גם לאחר עריכות. -- מיקום קבוע: בקבצי קוד, כאשר אין עוגן יציב, הפתק נשמר לפי שורה/קואורדינטות; שינויי טקסט גדולים עלולים לשנות את המיקום היחסי. +- עיגון יציב: אם יש כותרת Markdown ``id`` – הפתק נצמד לעוגן וכך נשמר גם לאחר עריכות. שילוב עם סימניות ----------------- @@ -47,14 +45,10 @@ ----------------------- - מגבלות שימוש: עד 200 פתקים לקובץ ועד 1000 פתקים לכל משתמש. - פרטיות: פתקים נשמרים לחשבון המשתמש בלבד, ואינם מוצגים לאחרים כברירת מחדל. -- אבטחה: - - אין הרצת JavaScript מקוד פתקים. - - בקבצי HTML, התצוגה נעשית בתוך ``sandbox`` לצורך בידוד. טיפים שימושיים --------------- - העדיפו עוגנים יציבים כדי לשמר דיוק גם לאחר עריכות. -- הגדירו קוד צבעים עקבי כדי לזהות משימות/סטטוסים במבט אחד. - נצלו פתקים לביקורת קוד עצמית ולמעקב משימות נקודתי בתוך קבצים גדולים. API קצר (למפתחים) @@ -104,8 +98,7 @@ API קצר (למפתחים) Troubleshooting קצר ------------------- - פתק "זז" לאחר עריכות גדולות בקוד: העדיפו להצמיד לעוגן יציב במקום לשורה גולמית. -- פתק לא נשמר: ודאו שיש הרשאות וששמורו בוצע בהצלחה (הודעת אישור בתצוגה). -- בעיות בתצוגת HTML: ודאו שפתקים מוצגים במסגרת ה‑``sandbox`` ולא נחסמים על‑ידי הדפדפן. +- פתק לא נשמר: ודאו שיש הרשאות ושהשמירה בוצעה בהצלחה (הודעת אישור בתצוגה). בעיות נפוצות בתזכורות ~~~~~~~~~~~~~~~~~~~~~~~