תבנית:דווח בפבריקטור
תבנית זו משמשת בדפי דיונים. מטרתה ליידע את הקהילה שבאג מסוים כבר דווח באתר פבריקטור, ובכך למנוע עבודה כפולה.
אופן השימוש בתבנית
[עריכה]יש להשתמש בתבנית באופן הבא: {{דווח בפבריקטור|מספר-הבאג}}
מספר הבאג מופיע בכתובת ה־URL בפבריקטור. הוא מוצג בכתובת אחרי האות T.
לדוגמה, כתובת ה־URL של הבאג הזה היא: https://phabricator.wikimedia.org/T2001
המספר שרשום אחרי האות T בכתובת ה־URL שלמעלה הוא 2001, וזה אומר שמספרו של הבאג הזה הוא 2001. כדי לקשר לבאג הזה באמצעות תבנית זו, יש להשתמש בתחביר הבא:
{{דווח בפבריקטור|2001}}
התחביר שלמעלה ייתן את התוצאה הבאה:
הערה – שימו לב לא לכלול את האות T בפרמטר של התבנית!
ניתן להוסיף לתבנית פרמטרים נוספים המציגים מידע נוסף על הבאג. להלן הפרמטרים האפשריים:
בקשה
[עריכה]ניתן להוסיף לתבנית את הפרמטר |בקשה=כן כדי לציין שמה שפורסם בפבריקטור אינו דיווח על באג, אלא בקשה להוספת תכונה לאתר בעקבות דיון:
{{דווח בפבריקטור|2001|בקשה=כן}} ←מצב
[עריכה]אפשר לציין בתבנית את המצב של הבאג או הבקשה. לדוגמה, אפשר לציין שהבאג תוקן או נדחה, ואפשר גם לציין שהבאג מסומן כ"קריטי" (למשל חורי אבטחה).
ציון המצב נעשה באמצעות הפרמטר |מצב=X, כאשר X מוחלף באחד הערכים הבאים:
{{דווח בפבריקטור|2001|מצב=תוקן}} ←
{{דווח בפבריקטור|2001|בקשה=כן|מצב=טופל}} ←
{{דווח בפבריקטור|2001|מצב=לא יתוקן}} ←
{{דווח בפבריקטור|2001|מצב=שגוי}} ←
{{דווח בפבריקטור|2001|מצב=נדחה}} ←
{{דווח בפבריקטור|2001|מצב=קריטי}} ←גריט
[עריכה]כאשר המפתחים מבצעים שינויים בתוכנת מדיה־ויקי, בין אם השינוי משפיע על מיזם ספציפי בלבד ובין אם הוא משפיע על כל אתרי הוויקי, השינוי מתועד באתר גריט (Gerrit). באתר פבריקטור יש בוט שמוסיף לדפי הבאגים קישורים לדפי גריט באופן אוטומטי. בדרך־כלל זה נעשה לאחר שהתיקון של הבאג בוצע (או שהבקשה טופלה).
בתבנית הזו אפשר להוסיף קישור לתיעוד רלוונטי באתר גריט. לשם כך, יש להשתמש בפרמטר |גריט=מספר-התיעוד.
גם התיעודים בגריט מסודרים לפי מספרים, אבל שימו לב שמספר התיעוד בגריט אינו זהה למספר הבאג בפבריקטור.
מספר התיעוד באתר גריט מופיע גם הוא בכתובת ה־URL. לדוגמה, כתובת ה־URL של התיעוד הזה היא: https://gerrit.wikimedia.org/r/#/c/60948/
המספר שרשום בכתובת ה־URL שלמעלה הוא 60948, וזה אומר שמספרו של התיעוד הזה הוא 60948. כדי להוסיף לתבנית קישור לתיעוד הזה, יש להשתמש בתחביר הבא:
{{דווח בפבריקטור|49680|מצב=תוקן|גריט=60948}} ←יישור
[עריכה]כברירת מחדל, התיבה שמודיעה שהבאג דווח בפבריקטור מוצגת בצד שמאל.
במקרים מסוימים (בדרך־כלל כשהצבעה על שינוי מסוים נערכת באנגלית משמאל לימין לטובת המפתחים שיראו אותה), יש ליישר את התבנית הזאת לצד ימין כדי שלא תתנגש עם ההצבעה.
אפשר לעשות זאת באמצעות הפרמטר |יישור=ימין.