שיחת תבנית:תיעוד

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

הוחלט בזמנו שלא יוצרים דפי משנה במרחב הערכים. אל תמשיך במיזם זה לפני שיתקיים דיון. חגי אדלרשיחהל-65 ערי מיליונים אין עדיין ערך. קחו אחת! • י"ג בסיוון ה'תשס"ט • 10:40, 5 ביוני 2009 (IDT)[תגובה]

לא מדובר במרחב הערכים, אלא במרחב התבניות. מרחב שהוא טכני מיסודו, ומשתמשים ממוצעים לא מגיעים אליו. אני חושב שהעברת התיעוד לעמוד נפרד תפשט מאד את העבודה עם תבניות, ואפשר לראות שרעיון זה פופולרי מאד בוויקיפדיה האנגלית. אפנה לדיון זה מלוח המודעות. יובל מדר - שיחה 10:46, 5 ביוני 2009 (IDT)[תגובה]
מרחב התבניות הוא חלק ממרחב הערכים. חגי אדלרשיחהל-65 ערי מיליונים אין עדיין ערך. קחו אחת! • י"ג בסיוון ה'תשס"ט • 11:06, 5 ביוני 2009 (IDT)[תגובה]
מרחב התבניות הוא לא מרחב הערכים. קליק ימני "הצג מקור" חפש wgNamespaceNumber ותיווכח שלא. באופן ספציפי: אני מעדיף שהתיעוד יהיה בדף התבנית עצמו ולא דף משנה, אך במקרים של "הגנה" כמו שמוסבר בדף התבנית בהחלט כדאי להוסיף את התיעוד בדף משנה. אני לא בטוח אבל שיש צורך בתבנית הזו, ולדעתי התחביר {{/תיעוד}} ברור יותר. ערן - שיחה 11:11, 5 ביוני 2009 (IDT)[תגובה]
גם אני מעדיף שהתיעוד יהיה בדף התבנית עצמו ולא בדף משנה - הפיצול יוצר סרבול מיותר. דוד שי - שיחה 11:41, 5 ביוני 2009 (IDT)[תגובה]
גם אני. במקרים נדירים שמתי את התיעוד בדף אחר, וגם אז עדיף להשתמש בתחביר שציין ערן, על פני תבנית זו. ‏Yonidebest Ω Talk01:46, 6 ביוני 2009 (IDT)[תגובה]
שיטה זו נהוגה בויקיאנגלית, אך לדעתי היא לא מוצלחת ומסרבלת את לימוד התבנית. דוד א. - שיחה 22:16, 6 ביוני 2009 (IDT)[תגובה]

תבנית זו לא מוצגת כראוי בתבנית:נק"ל. ‏«kotz» «שיחה» 17:14, 18 ביולי 2015 (IDT)[תגובה]

מדוע קיים הרקע סביב התיעוד? אורשיחה16:38, 3 בפברואר 2017 (IST)[תגובה]

ערן מדוע הרקע שונה? אני מבקש בבקשה להחזיר אותו לכיצד שהיה. זה נורא מפריע ככה. – אסף (Sokuya)שיחה 19:15, 5 במאי 2017 (IDT)[תגובה]

סגירת ה-DIV[עריכת קוד מקור]

למה לא סוגרים את ה-div? זה לכאורע מציג את כל מה שלמטה בתוך מסגרת, גם אם בפועל זה לא נמצא בדף התיעוד. ומכאן שהכיתוב: "המידע מטה מוצג מתוך הדף תבנית:תיעוד/תיעוד." שגוי. אינג. יונה ב. - שיחה - הבה נכחילה 16:19, 14 ביוני 2017 (IDT)[תגובה]

תיעוד תבנית ה-TemplateData להבנתי צריך להישאר בדף התבנית כדי לעבוד. ברגע שסגרת את ה-div זה הוציא את אותו תיעוד מהמסגרת וגרם לבעיה עיצובית. קיימת יחידה:תיעוד שהיא למעשה היחידה/תבנית שמשתמשים בה בכל הויקיפדיות האחרות. שם התיעוד של תבנית ה-TemplateData נמצא כולו בדף התיעוד (ולא בעמוד התבנית), ראה לדוגמה Template:Location map. כפי שניתן לראות, התבנית שלנו היא הכנה מלאכותית, חריגה ושונה משאר הויקיפדיות ובפרט מהיחידה. ניתן לראות העיצוב השונה בראש הערך ובהודעה בתחתיתו. כאשר אתה סוגר את ה-div אתה מונע מהאופציה היחידה שעובדת כעת לעבוד. אולי מוטב לשנות את הניסוח או לפתור את הבעיה מהשורש ולתרגם את היחידה ולהכניס אותה לשימוש. כרגע אין שום דרך אחרת שתיעוד הtemplatedata יכלל במסגרת מבלי לפגוע בתפקודו. – אסף (Sokuya)שיחה 16:30, 14 ביוני 2017 (IDT)[תגובה]
אולי זה נובע מהקוד בתבנית:ניהול פרמטרים/תוכן. אבל נאמר לי שעל התבנית האחרונה וה-TemplateData להיות בעמוד התבנית ולא בתיעוד שלה. איני יודע אם זה עובד אחרת. זה כמובן שונה מויקיפדיות האחרות. – אסף (Sokuya)שיחה 16:36, 14 ביוני 2017 (IDT)[תגובה]
אתה מערבב בין שני דברים. האחד העיצוב והשני הפונקציונליות. ה-div הזה לא עושה שום דבר פונקציונלי בגדול הוא יוצר רק את המסגרת והרקע. העובדה ש-templatedata נמצא בתוך ה-div או לא, לא משנה את הפונקציונליות שלה. בנוגע לעיצוב, אם כל התיעוד חוץ מ-templatedata נמצא בדף משנה וה-templatedata נמצא בתחתית התיעוד, מה זה מפריע שהרקע שונה? templatedata נמצא בדף התבנית בגלל שכך עובד ניהול פרמטרים, כפי שכתבת וזה כרגע לא משתנה. מה ששיניתי זה את הרקע שבו זה יופיע השארת המסגרת פתוחה היא המקור לבעיות אפשריות ולא להיפך. אינג. יונה ב. - שיחה - הבה נכחילה 17:10, 14 ביוני 2017 (IDT)[תגובה]
איני יודע עדיין איך ניהול הפרמטרים עובד אצלנו, לא חקרתי זאת. אבל נאמר לי שעל תבנית ההודעה על הניהול ועל ה-TemplateData עצמו להיות בדף התבנית ולא בדף התיעוד כדי לעבוד. אני בטוח שישנה דרך להעביר אותם לדף התיעוד וגם לגרום לניהול הפרמטרים לעבוד (הרי זה עובד כך בכל ויקיפדיה אחרת). סגירת ה-div כעת פוגעת בעיצוב ואיני מכיר שהיא פותרת בעיה פונקציונלית מאחר ולא ידוע לי על בעיות שנובעות ממנה כעת. אני מסכים שאידיאלית יש לסגור את ה-div כדי למנוע מבעיות כאלו לצוץ בעתיד, אבל במקרה כזה יש לבצע את העבודה מהשורש ולא רק "חצי עבודה". מבחינה אידיאלית גם על ניהול הפרמטרים להיות בדף התיעוד. כרגע אין בעיה פונקציונלית שנובעת מאי סגירת הdiv ואם הניהול פרמטרים לא משתנה כרגע (כפי שכתבת) אני לא רואה סיבה לשנות את המצב הקיים גם כן. בעיות עיצוביות הם בעיות שמפריעות ולא צריך לזלזל בהם. טכנולוגיה ו-Desing הולכים יד ביד. סגירת ה-div פותרת בעיה תיאורטית אחת אבל באותו הזמן יוצרת בעיה פרקטית אחרת. ולכן כמו שהצעתי יש לפתור ולתקן את הבעיות מהשורש ולא בחצי עבודה ואני מוכן לעבוד ביחד איתך ולעזור בכך. במילים אחרות, כן זה מפריע שהרקע והמסגרת נחתכים פתאום, ולא רק לי. לא עושים "חצאי עבודה". – אסף (Sokuya)שיחה 17:39, 14 ביוני 2017 (IDT)[תגובה]
עד כמה שאני יודע, ניהול פרמטרים הוא משהו שמשתמש:קיפודנחש יצר ואני לא חושב שזה נמצא בוויקיפדיות אחרות. מכתב גם את בורה בורה. אינג. יונה ב. - שיחה - הבה נכחילה 07:31, 15 ביוני 2017 (IDT)[תגובה]
יש דיבורים לייצא לגויים, אבל כרגע רק היהודים משתמשים בניהול הפרמטרים. בורה בורה - שיחה 07:34, 15 ביוני 2017 (IDT)[תגובה]
נתחיל מההתחלה: אין שום תירוץ לא לסגור את ה-div, ואכן סגרתי אותו. אם למישהו כואב שה-TD מופיע בלי רקע ירוק אז צר לי, אבל זה לא יכול לשמש תירוץ ליצירת קוד לא חוקי (יש לנו עוד כמה תבניות כאלה, ובפרט {{ארכיון}} - אין לי רעיון טוב להתמודד עם זה שם, אבל זה לא תירוץ לעשות זאת כאן).
שנית, מערכת ניהול הפרמטרים יכולה לעבוד בנוחיות כשה-TD בדף התיעוד (נכון שבדקתי זאת מאד מזמן, אבל אם זה לא עובד, זה משהו שקל מאד לתקן), כך שגם זה לא תירוץ לכלום.
הסיבה שבכל זאת ה-TD חייב להיות בדף התבנית היא הכלי שמיוריאל שעובדת בויקימדיה יצרה, ומופעל על ידי הכפתור "ניהול נתוני תבנית" כשנכנסים למצב עריכה בדף התבנית. הכלי הזה מסתדר עם מצב שה-TD נמצא בדף משנה בשם doc, אבל לא עם מצב ששם דף המשנה הוא "תיעוד". אולי יש לדבר תקנה פשוטה (נגיד בעזרת איזו "הודעת מערכת"), אבל לא ידוע לי מהי, וכרגע לאף אחד אין מספיק מוטיבציה לבזבז על זה זמן - מתברר שהשארת ה-TD בדף התבנית זה לא נזק, ואולי זה אפילו הדבר הנכון לעשות: ה-TD משפיע על מערכת הבדיקות, ועל האשפים בעורך החזותי ועורך קוד מקור, ואולי עדיף שכאשר התבנית מוגנת והתיעוד לא (מצב שכיח בתבניות מוגנות), ה-TD יקבל ההגנה של התבנית ולא של התיעוד. כך או כך או כך, זה המצב וזו הסיבה, ולקינוח אחזור על מה שכתבתי למעלה: סגרתי את ה-div, ואסף מתבקש לא להסיר את הסגירה. קיפודנחש 08:03, 15 ביוני 2017 (IDT)[תגובה]
קיפודנחש האם הבעיה שתארת לדף משנה בשם "תיעוד" דווח בפאביקטור? אם הבעיה היא רק השימוש בכלי ליצירת נתוני התבנית, אפשר לאחר היצירה להעביר לדף משנה למרות שזה לא נוח. אינג. יונה ב. - שיחה - הבה נכחילה 08:27, 15 ביוני 2017 (IDT)[תגובה]
נגד חזק שה-TD לא יהיה בתבנית. בכח אתם מחפשים צרות? כבר יותר משנה עובדים כך והכל דופק יפה. לשם מה לעשות עכשיו נסיונות, שבעבר לא עלו יפה. אז הרקע לא יהיה ירוק... מי רואה את זה בכלל? אם אני רואה TD בתיעוד אני משחזר מיד. בורה בורה - שיחה 08:34, 15 ביוני 2017 (IDT)[תגובה]
כן, זה דווח בפבריקטור (לפני אולי שנתיים), אבל זה נופל בצוות של פורסטר, ולמרות שהוא לא פעיל בוויקיפדיה בעברית, אני מנועה מלכתוב כאן את דעתי על התנהגותו כראש צוות העורך החזותי, ועל תגובתו לדיווח בגים ולבקשות של הקהילות - כתיבת דעתי עליו כאן תהווה הפרה בוטה של כללי ההתנהגות. די לומר שבגלל התנהלותו, התעכבה הפעלת העורך החזותי בוויקינגליש בשנים לא מעטות. לגבי "להפעיל את הכלי בדף התיעוד" - אתה מחמיץ את הנקודה. כל הקסם בכלי הזה היא העובדה שהוא יודע ללקט את הפרמטרים מהתבנית עצמה, והפעלתו בדף התיעוד מאבדת את היתרון הזה, ולכן אינה באה בחשבון. לא ברור לי למה זה חיוני, או אפילו טוב שה-TD יהיה צבוע בירוק. לדידי, ה-TD יכול בכלל להיות מוסתר. אין שום ערך בהצגתו הוויזואלית (ואם זה בכל זאת נורא חשוב, אפשר לעשות זאת בעזרת CSS - אתה מפעיל, לא?). קיפודנחש 08:49, 15 ביוני 2017 (IDT)[תגובה]
עכשיו בלבלת אותי. מצד אחד אתה כותב שאם דף המשנה היה doc אז זה יכול יופיע בדף המשנה ועכשיו אתה כותב שזה לא רעיון טוב כי הוא "מלקט פרמטרים מהתבנית" ושימוש בדף משנה מאבד את זה. אבל התבניות לא משתנות על בסיס יומי ולאחר יצירה של ה-TD מה הבעיה להעביר לדף המשנה? אז נכון שתבנית שתעבור עכשיו שדרוג צריך יהיה ליצור TD חדש או להעביר זמנית את ה-TD לתבנית על מנת לשדרגו גם כן. אך כמו שאמרתי זה לא נוח אבל מלבד חוסר הנוחות אני לא רואה בעיה. ולשם ההבהרה, גם אני לא רואה בעיה בכך שה-TD לא יהיה ברקע ירוק כתבתי זאת למעלה בתגובתי מה17:10, 14 ביוני 2017. בנוגע לכך שלא יוצג, אין לי התנגדות שזה לא יוצג כברירת מחדל אבל כן תהיה אפשרות לראות את זה למי שמעוניין (כמו הצגת קטגוריות נסתרות או הצגת הבעיות הפרמטרים של ניהול הפרמטרים) כי אני משתמש במידע שמופיע שם ולעיתים מעדכן אותו ואני לא מעוניין להכנס למצב עריכה כל פעם בשביל לראות את המידע. כמה כמוני יש? בודדים אבל בשביל אום בודדים צריך ליצור מצב שזה יוצג (לא יודע מה עשית בניהול פרמטרים אבל אולי אפשר להשתמש באותו טריק גם כאן?) נ.ב. אני מפעיל ויש לי רקע גבוה יחסית בטכנולוגיה אולם אני לא מכיר JS או CSS ברמה של להתחיל לשנות שם דברים. אם זה היה במטלב או ב-R זה כבר היה עניין אחר... אינג. יונה ב. - שיחה - הבה נכחילה 09:18, 15 ביוני 2017 (IDT)[תגובה]
יונה בדיון אחר אמרת לי כי דפי תיעוד נפרדים זה "מטרד מרגיז". גם בעיני הם לא אהודים... אז מה פתאום התאהבת בהם ואתה רוצה להעביר לשם את ה-TD כדי למרר לנו את החיים? בורה בורה - שיחה 09:29, 15 ביוני 2017 (IDT)[תגובה]
תלוי מה יש בתיעוד. עדכון תבנית צריך להתקיים במקום אחד - בדף התבנית. בדף התיעוד צריך להיות דוגמאות והסברים שהם לרוב לא משתנים. כמובן שאם נוסף פרמטר או מוסר פרמטר יש לעדכן את התיעוד הרלוונטי אבל זה כבר לא קשור לתבנית. מה שאני העלתי בדיון אחר הוא שבתבניות של מזהים שנמשכים מוויקינתונים, בתיעוד לא משתמשים באזכור התבנית כי אז התיעוד יהיה ריק, שם כותבים מחדש את התבנית עצמה כדי לקבל דוגמא ולכן יש שם כפילות בעדכון גם בתבנית וגם בדף התיעוד. במקרה הזה אני עוד מנסה להבין האם מיקום בדף התיעוד, כדי שיהיה באותו רקע, הוא בעייתי או לא ועד עכשיו שאלתי שאלות ולא אמרתי את דעתי כי כרגע אני לא יודע מה עדיף. אם תסתכל בהיסטוריה של התבנית הזאת, את השינוי שעשה היום קיפודנחש עשיתי אתמול והביטול של אסף היה הזרז לדיון זה. אינג. יונה ב. - שיחה - הבה נכחילה 09:39, 15 ביוני 2017 (IDT)[תגובה]
קיפודנחש לי יש מוטיבציה, אשמח אם תשתף אותי או תדריך אותי מה יש לעשות, אני אציק למי שצריך. אגב גם בויקיפדיה באנגלית קיים TD וקיים ניהול פרמטרים אני לא יודע מה השוני בכל אופן. צריך לפתור את הבעיה מהשורש. – אסף (Sokuya)שיחה 18:29, 15 ביוני 2017 (IDT)[תגובה]
אסף מדובר על מערכת שמסייעת בקטלוג ערכים בקטגוריה:שגיאות_פרמטריות_לפי_תבנית על בסיס ה־TD (ערך יופיע שם אם יהיה בתבנית פרמטר שלא קיים ב-TD או שלא מוזן ערך בפרמטר שמוגדר חובה וכדומה). אינג. יונה ב. - שיחה - הבה נכחילה 08:14, 18 ביוני 2017 (IDT)[תגובה]