ארבעה כללים לכתיבת קוד אדיב

30/09/2023

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

  1. קוד אדיב לא עושה לך עבודה. הוא לא מבקש ממך שתשדרג כל יומיים ולא מכריח אותך לשנות את הקוד שלך כל פעם ששידרגת גירסה. אם כבר הכניסו שינויים גדולים הם ישמרו על תאימות אחורה.

  2. קוד אדיב יודע לעבוד קצת בשבילך. הוא לא כולל הרבה תלויות ואם כבר יש הוא יביא אותם איתו. הוא גם יגיע עם תיעוד מקיף שכולל הרבה דוגמאות שאפשר כבר לקחת ולהתחיל מהן.

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

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