באג | תוצאה שונה בתוצאות חיפוש מבספר עצמו.

[מישהו 1]

למדתי בספר חזון איש, והיה כתוב דפנוח, במקום דפנות, שלחתי לתיקון, ועל הדרך החלטתי לעשות חיפוש של המילה דפנוח, שזה ודאי יהיה טעות של דפנות.
ומצאתי עוד פעם אחת בספר חזון איש על טהרות, אלא שכשנכנסתי לתוצאה, היה כבר מתוקן התוך הספר.
מה לעשות? לדווח על טעות? ואם כן, איך?

[Otzaria-Bot]

בהחלט, זוהי תצפית חשובה המעידה על באג בתוכנה.

מה לעשות? לדווח על טעות?
כן, מומלץ מאוד לדווח על טעות זו. התנהגות שבה תוצאות החיפוש אינן משקפות את הטקסט המעודכן שבתוך הספר מצביעה על חוסר סנכרון באינדקס החיפוש של התוכנה, וזהו באג שיש לתקן. למרות שהטקסט בספר עצמו תוקן, העובדה שחיפוש עדיין מעלה את הגרסה השגויה מראה שהבעיה במנגנון החיפוש/אינדוקס.

ואם כן, איך?
הדרך המקצועית והמועדפת לדווח על באגים בתוכנת אוצריא היא דרך מערכת ה-Issues בגיטהאב, מאחר וקוד המקור של התוכנה זמין שם. ישנם שני מאגרי גיטהאב רלוונטיים:

1. לדיווח על בעיות הקשורות לתוכנה עצמה (כמו במקרה שלך – בעיית סנכרון בחיפוש):
   עליך לפתוח "Issue" חדש במאגר התוכנה:
   https://github.com/Sivan22/otzaria/issues

2. לדיווח על טעויות בתוכן הספרים (כמו השגיאה המקורית "דפנוח" במקום "דפנות"):
   עבור טעויות בתוכן הספרים עצמם, גם אם כבר נשלחו לתיקון, המאגר המתאים הוא:
   https://github.com/Sivan22/otzaria-library/issues

במקרה הספציפי שלך, מכיוון שהטעות המקורית (בספר) תוקנה, אך תוצאת החיפוש עדיין שגויה, הדיווח צריך להיות בקישור של התוכנה עצמה (Sivan22/otzaria/issues).

כיצד לנסח את הדיווח?
בעת פתיחת הדיווח בגיטהאב, אנא כלול את הפרטים הבאים:

• כותרת ברורה: "באג: תוצאות חיפוש מציגות טקסט שגוי למרות תיקון הספר" (או דומה).
• תיאור מפורט של הבעיה:
  • ציין את שם הספר המדויק (חזון איש על טהרות).
  • תאר את מילת החיפוש שהשתמשת בה ("דפנוח").
  • הסבר שתוצאת החיפוש מציגה את המילה השגויה, אך כאשר נכנסים לתוצאה, הטקסט בתוך הספר כבר תוקן (ל"דפנות").
  • ציין את גרסת תוכנת אוצריא שבה אתה משתמש (זהו פרט חשוב בתחום דיווחי באגים).
• שלבים לשחזור הבעיה:
  1. פתח את תוכנת אוצריא.
  2. חפש את המילה "דפנוח".
  3. הבחן בתוצאה בספר "חזון איש על טהרות".
  4. לחץ על התוצאה וודא שבתוך הספר המילה כבר "דפנות".
• התוצאה הרצויה: תוצאות החיפוש צריכות לשקף את הטקסט המעודכן שבתוך הספרים.

דיווח מפורט כזה יסייע למפתחי אוצריא להבין ולתקן את הבעיה בצורה יעילה.

יצוין כי לעיתים מתפרסמים עדכוני תוכנה ותיקוני באגים (למשל, עדכונים לשיפור סריקת קבצים ותוצאות חיפוש). ייתכן שבעיה זו קשורה גם לתהליך האינדוקס של הספרים המותקנים אצלך, ולכן חשוב לציין את גרסת התוכנה.

בהצלחה עם הדיווח!

[יום חדש מתחיל]

@מישהו-1 כי אני כבר תיקנתי אחרי ששלחת את הדיווח.
אבל האינדקס שלך לא מעודכן, הוא כולל את הטקסט הישן.

[מישהו 1]

לא, אני מדבר על תיקון שעוד לא שלחתי.
שלחתי רק שתי תיקונים, וזה תיקון שלישי.
שתי התיקונים ששלחתי (בעירובין) מעודכנים גם בתוצאת חיפוש, וזה לא עולה בחיפוש דפנוח..
התוצאה השלישית, שזה אחרי שחיפשתי. זה בטהרות וזה לא עידכנתי, וזה לא מעודכן בתוצאות חיפוש ואילו בהצגת תוכן זה כן עולה מתוקן.

[מישהו 1]

בחיפוש דפנוח, זה מה שעולה. (על הריטב"א שלחתי עידכון,)
וכשנכנסים לחזון איש, אין שם כלום.

[D9]

תעדכן את האינדקס
תמחק את תיקיות האינדקס ותאנדקס הכל מחדש
כל שינוי בין הספר לתוצאות החיפוש הוא בגלל שהאינדקס נוצר לפני השינוי של הספר (החיפוש הוא באינדקס ולא בספר עצמו)

[יום חדש מתחיל]

@מישהו-1 אתה יכול לפתוח את קובץ הטקסט עצמו דרך פנקס רשימות, ותראה שלא תמצא את זה.

אני יודע ששלחת רק שתי תיקונים,
אבל כרב אז על הדרך עשיתי חיפוש בכל הספר של 'דפנוח' ומצאתי גם את השלישי, ותיקנתי גם אותו.

[מישהו 1]

אבל יש כאן משהו מוזר, שלגבי שתי התיקונים שבעירובין, האינדקס כן התעדכן.
ואילו לגבי התיקון שבטהרות, האינדקס לא התעדכן.
זה הנקודה שאני רוצה להדגיש.
אצלי אני יכול לתקן את האינדקס אם אני ימחוק אני יודע.
אני מנסה להבין, כל תיקון של מילה בקובץ, זה נותן הוראה לאינדקס לאנדקס מחדש את הקובץ?
כי מזה שבעירובין תוקן גם באינדקס, אני מבין שיש את ההוראה הזו.
ואיך שאני מבין, בטהרות למרות שתוקן לא נתנו את ההוראה לעדכן את האינדקס,
אני מלא כאן השערות אבל אני חושב שזה השערות מסתברות

[יום חדש מתחיל]

אני חושב שאין כזה דבר [כרגע, עד המעבר לDB] לעדכן את האינדקס, אלא צריך תמיד ליצור מחדש.
אז איך בעירובין זה הסתדר?
קושיא טובה!
אולי ל @י.-פל. יש תשובה

[י. פל.]

@יום-חדש-מתחיל כתב בבאג | תוצאה שונה בתוצאות חיפוש מבספר עצמו.:

אני חושב שאין כזה דבר [כרגע, עד המעבר לDB] לעדכן את האינדקס, אלא צריך תמיד ליצור מחדש.
אז איך בעירובין זה הסתדר?
קושיא טובה!
אולי ל @י.-פל. יש תשובה

את האינדקס לא יהיה ניתן לעדכן גם לאחר המעבר לDB.