מדיניות תוכן ושקיפות

עדכון אחרון: 26 באוקטובר 2026

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

משימה אחת, קוד שאפשר להריץ

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

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

שלושה קווים שלא חוצים

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

מקורות

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

איך התוכן נכתב

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

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

בלי קורסים ובלי הבטחות

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

תאריכים וגרסאות

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

תיקונים

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

עצמאות

מועדון המפתחים הוא אתר מערכתי עצמאי. הוא אינו קורס, אינו לוח דרושים, אינו שירות פיתוח ואינו מדבר בשם אף חברה, פרויקט קוד פתוח או קהילה. הוא אינו קשור לשום כנס, ארגון או אדם שפעלו בעבר בכתובת osdc.org.il, ואינו ממשיך, ארכיון או אתר רשמי של אף אחד מהם.

מאמרי אורח

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