Versioning & Stable Anchors
מדיניות עוגנים יציבים
לא לשבור מזהי עוגנים קיימים (refs) בין גרסאות.
לשמור שמות כותרות ועוגנים מרכזיים קבועים; שינויים מינוריים יעברו בהערה.
בעת שינוי מבני: ליצור עוגנים תואמים (aliases) או קישורי מעבר.
What’s New
שמרו עמוד
whats-new.rstעם שינויים משמעותיים.כל שינוי שובר-תיעוד או עוגן יופיע ברשימה עם תאריך וגרסה.
איך כותבים רשומה — בולט לכל עדכון, שנפתח בפתיח מודגש וייחודי בעמוד, כדי שהחיפוש בתיעוד יציג אותו כתוצאה משלו: רשומה ב-What’s New.
דוגמת Anchors
.. _files-list:
Files list
==========
...