From 9e2eaa6aa96ca590dd88399c1abecbca292aee1b Mon Sep 17 00:00:00 2001 From: amir haim Date: Fri, 21 Aug 2026 00:06:53 +0300 Subject: [PATCH 1/5] Update sticky_notes.rst --- docs/user/sticky_notes.rst | 17 +++++------------ 1 file changed, 5 insertions(+), 12 deletions(-) diff --git a/docs/user/sticky_notes.rst b/docs/user/sticky_notes.rst index 15de01c55..559e401c5 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,8 @@ * - הוספת פתק - לחיצה על כפתור הפתקים בתצוגת הקובץ ואז לחיצה בנקודה הרצויה - מומלץ להצמיד לעוגנים יציבים (כותרת/``id``) כשאפשר, לשמירה לאחר עריכות - * - עריכת תוכן/צבע - - קליק על פתק קיים ועריכת השדה/בחירת צבע מהתפריט - - צבעים עוזרים לסיווג מהיר (למשל ירוק=בוצע, אדום=דחוף) + * - עריכת תוכן + - קליק על פתק קיים ועריכת השדה * - הזזה/מיקום מחדש - גרירה קצרה של הפתק למיקום חדש בתצוגה - אם הפתק מעוגן לעוגן יציב – ההצמדה תישמר, והמיקום החזותי יעדכן @@ -33,7 +31,7 @@ עיגון יציב לעומת מיקום קבוע ----------------------------- -- עיגון יציב: אם יש כותרת Markdown או אלמנט HTML עם ``id`` – הפתק נצמד לעוגן וכך נשמר גם לאחר עריכות. +- עיגון יציב: אם יש כותרת Markdown ``id`` – הפתק נצמד לעוגן וכך נשמר גם לאחר עריכות. - מיקום קבוע: בקבצי קוד, כאשר אין עוגן יציב, הפתק נשמר לפי שורה/קואורדינטות; שינויי טקסט גדולים עלולים לשנות את המיקום היחסי. שילוב עם סימניות @@ -47,14 +45,10 @@ ----------------------- - מגבלות שימוש: עד 200 פתקים לקובץ ועד 1000 פתקים לכל משתמש. - פרטיות: פתקים נשמרים לחשבון המשתמש בלבד, ואינם מוצגים לאחרים כברירת מחדל. -- אבטחה: - - אין הרצת JavaScript מקוד פתקים. - - בקבצי HTML, התצוגה נעשית בתוך ``sandbox`` לצורך בידוד. טיפים שימושיים --------------- - העדיפו עוגנים יציבים כדי לשמר דיוק גם לאחר עריכות. -- הגדירו קוד צבעים עקבי כדי לזהות משימות/סטטוסים במבט אחד. - נצלו פתקים לביקורת קוד עצמית ולמעקב משימות נקודתי בתוך קבצים גדולים. API קצר (למפתחים) @@ -105,7 +99,6 @@ Troubleshooting קצר ------------------- - פתק "זז" לאחר עריכות גדולות בקוד: העדיפו להצמיד לעוגן יציב במקום לשורה גולמית. - פתק לא נשמר: ודאו שיש הרשאות וששמורו בוצע בהצלחה (הודעת אישור בתצוגה). -- בעיות בתצוגת HTML: ודאו שפתקים מוצגים במסגרת ה‑``sandbox`` ולא נחסמים על‑ידי הדפדפן. בעיות נפוצות בתזכורות ~~~~~~~~~~~~~~~~~~~~~~~ From 0716e8dcbb00c53adaf71a3af357e83e87c3b399 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 20 Aug 2026 21:38:55 +0000 Subject: [PATCH 2/5] =?UTF-8?q?docs(sticky-notes):=20=D7=A8=D7=A2=D7=A0?= =?UTF-8?q?=D7=95=D7=9F=20AI-MAP=20=D7=95=D7=94=D7=A9=D7=9C=D7=9E=D7=AA=20?= =?UTF-8?q?=D7=94=D7=AA=D7=90=20=D7=94=D7=97=D7=A1=D7=A8=20=D7=91=D7=98?= =?UTF-8?q?=D7=91=D7=9C=D7=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit שני תיקונים לכשל ה-CI: 1. Unit Tests (3.11/3.12) נפלו על test_map_matches_the_current_docs — שורת ה-:summary: השתנתה ו-AI-MAP.md נשאר עם הישנה. המפה חודשה בהרצת המחולל. 2. מחיקת עמודת "הערות" משורת "עריכת תוכן" השאירה את ה-list-table עם שתי עמודות בשורה אחת מול שלוש בשאר. בבנייה תחת -W זה ERROR: uniform two-level bullet list expected... (2 vs 3). בדיקת התיעוד ב-CI לא תפסה את זה כי documentation.yml מריץ sphinx בלי -W; ה-workflow שכן מריץ עם -W הוא workflow_dispatch בלבד. RTD, לעומת זאת, נכשל על אזהרות. תוכן התא אומת מול הקוד: מגבלת 5,000 תווים מ-sticky_notes_api.py (_sanitize_text / max_decoded_chars), והיעדר בחירת צבע בממשק מ-sticky-notes.js שמקבע '#FFFFCC' ביצירה ואינו חושף בורר. בנייה: sphinx -W --keep-going על כל התיעוד — exit 0, אפס אזהרות. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_019YULCppaQRPYN1RgeY6NBu --- AI-MAP.md | 2 +- docs/user/sticky_notes.rst | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/AI-MAP.md b/AI-MAP.md index f6ff45f68..94bcb9c73 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 559e401c5..b006a5b42 100644 --- a/docs/user/sticky_notes.rst +++ b/docs/user/sticky_notes.rst @@ -22,6 +22,7 @@ - מומלץ להצמיד לעוגנים יציבים (כותרת/``id``) כשאפשר, לשמירה לאחר עריכות * - עריכת תוכן - קליק על פתק קיים ועריכת השדה + - התוכן מוגבל ל‑5,000 תווים; אין בחירת צבע בממשק והפתק צהוב אחיד * - הזזה/מיקום מחדש - גרירה קצרה של הפתק למיקום חדש בתצוגה - אם הפתק מעוגן לעוגן יציב – ההצמדה תישמר, והמיקום החזותי יעדכן From a32f4f5b789aa7456ec850c3ecf2a4129331055e Mon Sep 17 00:00:00 2001 From: amir haim Date: Fri, 21 Aug 2026 00:48:42 +0300 Subject: [PATCH 3/5] Update docs/user/sticky_notes.rst Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com> --- docs/user/sticky_notes.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user/sticky_notes.rst b/docs/user/sticky_notes.rst index b006a5b42..09bfc5801 100644 --- a/docs/user/sticky_notes.rst +++ b/docs/user/sticky_notes.rst @@ -99,7 +99,7 @@ API קצר (למפתחים) Troubleshooting קצר ------------------- - פתק "זז" לאחר עריכות גדולות בקוד: העדיפו להצמיד לעוגן יציב במקום לשורה גולמית. -- פתק לא נשמר: ודאו שיש הרשאות וששמורו בוצע בהצלחה (הודעת אישור בתצוגה). +- פתק לא נשמר: ודאו שיש הרשאות ושהשמירה בוצעה בהצלחה (הודעת אישור בתצוגה). בעיות נפוצות בתזכורות ~~~~~~~~~~~~~~~~~~~~~~~ From c48a4caf86b50f36039c395ee107f090b2620229 Mon Sep 17 00:00:00 2001 From: amir haim Date: Fri, 21 Aug 2026 00:52:45 +0300 Subject: [PATCH 4/5] Update sticky_notes.rst --- docs/user/sticky_notes.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/user/sticky_notes.rst b/docs/user/sticky_notes.rst index 09bfc5801..1d537d54a 100644 --- a/docs/user/sticky_notes.rst +++ b/docs/user/sticky_notes.rst @@ -1,6 +1,6 @@ פתקים דביקים (Sticky Notes) ============================= -:summary: הצמדת הערות קצרות על תצוגת קובץ (Markdown): הוספה וניהול, עיגון יציב לעומת מיקום קבוע, השילוב עם סימניות, ומגבלות הפרטיות והאבטחה. +:summary: הצמדת הערות קצרות על תצוגת קובץ (Markdown): הוספה וניהול, עיגון יציב לעומת מיקום קבוע, השילוב עם סימניות. מהם פתקים דביקים? ------------------- @@ -33,7 +33,6 @@ עיגון יציב לעומת מיקום קבוע ----------------------------- - עיגון יציב: אם יש כותרת Markdown ``id`` – הפתק נצמד לעוגן וכך נשמר גם לאחר עריכות. -- מיקום קבוע: בקבצי קוד, כאשר אין עוגן יציב, הפתק נשמר לפי שורה/קואורדינטות; שינויי טקסט גדולים עלולים לשנות את המיקום היחסי. שילוב עם סימניות ----------------- From 21be6e435be509089c5eb4e10a4e5cbc2d7a529b Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 20 Aug 2026 22:03:41 +0000 Subject: [PATCH 5/5] =?UTF-8?q?docs(sticky-notes):=20=D7=A8=D7=A2=D7=A0?= =?UTF-8?q?=D7=95=D7=9F=20AI-MAP=20=D7=90=D7=97=D7=A8=D7=99=20=D7=A7=D7=99?= =?UTF-8?q?=D7=A6=D7=95=D7=A8=20=D7=94=D7=AA=D7=A7=D7=A6=D7=99=D7=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit שתי עריכות ווב (a32f4f5, c48a4ca) קיצרו שוב את שורת ה-:summary: אחרי הקומיט הקודם, והמפה נשארה עם הגרסה הארוכה. שתי בדיקות נפלו על אותו פער: - test_ai_map_freshness::test_map_matches_the_current_docs - test_doc_summary_style::test_the_lint_checks_the_values_that_are_in_the_committed_map השנייה היא זו שנוספה בסבב האחרון כדי שלא תהיה טאוטולוגית — היא השוותה את מה שהלינט סורק מול AI-MAP.md המקומט, ותפסה את הפער מזווית שנייה. שתיהן נסגרות בהרצת המחולל. אומת: 58 בדיקות עוברות, sphinx -W --keep-going על כל התיעוד exit 0 עם אפס אזהרות, ו---check מדווח שהמפה עדכנית. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_019YULCppaQRPYN1RgeY6NBu --- AI-MAP.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AI-MAP.md b/AI-MAP.md index 94bcb9c73..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): הוספה וניהול, עיגון יציב לעומת מיקום קבוע, השילוב עם סימניות, ומגבלות הפרטיות והאבטחה. +- `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 של הגרסה שהייתה קיימת כשהוא נוצר, ולכן הוא מצמיד גרסה ואינו מבטיח את התוכן העדכני.