גרסאות ושינויים

יומן הגרסאות נמצא בגרסאות, לא כאן.

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

מה כל רשומת גרסה נושאת

שדה	מה הוא אומר
מספר גרסה	לפי לוח שנה, בצורה YYYY-MM. הוא מציין את החודש שבו נסגרה התכולה — לא תאריך התקנה ולא תאריך שחרור אצלכם
ערוץ	תכולה, אבטחה או תחזוקה. גרסת אבטחה מסומנת בתג נפרד ברשימה, כדי שהשאלה ״האם אני חייב להתקין״ תיענה במבט
עיקרי הגרסה	שתיים־שלוש שורות שאפשר לקחת בלי לפתוח
אזורים שהשתנו	חלקי המוצר שנגעו בהם

מעקב בלי להיכנס לאתר

יש הזנת Atom ו‑RSS לכל שפה, ב‑/he/atom.xml וב‑/he/rss.xml. היא נושאת מאמרים, מדריכים וגרסאות — לא את המילון, כי הגדרה אינה חדשה.

גרסת התיעוד אינה גרסת המוצר

כתובת של עמוד תיעוד נושאת את גרסת התיעוד בתוכה: /תיעוד/v1/…. הסימון בסרגל הצד אומר לאילו גרסאות מוצר התיעוד הזה מתייחס.

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