ניהול הקטלוג

גרסאות מודול: טיוטה ופרסום הם לא שני מצבים של מתג אחד

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

מאת צוות קו פורסם 2 דק׳ קריאה

"מודול" ו"גרסה של מודול" הם אותה שורה בפועל, ב-/catalogue/versions. כל החלטת עריכה תלויה בהבחנה הזאת, ולכן שווה לדעת בדיוק על מה מסתכלים לפני שנוגעים בכלום.

טיוטה: המקום שבו קורה העיצוב

גרסת מודול חדשה נפתחת כטיוטה, עם סלאג ומחרוזת גרסה שמקלידים בעצמכם — למשל arnona ו-1.3.0 — ותווית בכל שפה שהפלטפורמה כותבת בה (עברית, ערבית, רוסית ואנגלית; השרת פשוט לא יפרסם מודול בלי כל הארבע, כי התווית הזו היא הכיתוב על תג המקור מתחת לכל תשובה שמקורה בה, בכל שפה של כל תושב). בתוך טיוטה, יכולות ניתנות להצהרה, הצהרה מחדש ותיקון בחופשיות, כי שום דבר מחוץ לפלטפורמה עדיין לא רואה את הגרסה ואף עירייה לא משרתת את החוזה שלה.

פרסום הוא שער, והוא רץ לכיוון אחד בלבד

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

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

מה נשאר ניתן לעריכה אחרי פרסום, ומה לא

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

שני קישורים מכל גרסה, לשתי שאלות שהעמוד הזה לא עונה עליהן

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

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