אל תדאג: אתה מקצוען ואתה מתנהג כמו אחד כזה.

אנשי מקצוע משתמשים בכל המשאבים הזמינים כדי לבצע את העבודה, כולל תיעוד, קוד כתוב על ידי אחרים (ספריות), עזרה ממומחים וכו '.

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

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

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

מבחני תכנות הם דבר שונה במקצת.

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

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

האם שימוש בתיעוד כמפתח גורם לי להראות לא מקצועית?

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

רובנו devs לא זוכר אלפי שורות של תיעוד ... כל הזמן,

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

החברות הסבירות ביותר היו רוצות לבדוק את ההיגיון / מבנה שאתה מעלה מבחן קידוד .. לא כל כך הרבה על תחביר.

מישהו אמר לי פעם משהו כמו: "מנתח לא יכול לקרוא את ספריו בכל פעם שהוא צריך לנתח חולה."

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

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

מקצועיות וידע הם שני דברים שונים לחלוטין.

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

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

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

קריאה נוספת על אפקט אשר מנוגד ל"אסטרטגיית השימוש בתיעוד "שלך: אפקט Dunning – Kruger

האם השימוש בתיעוד כמפתח גורם לי להראות לא מקצועית?

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

אני לועג על השימוש ב- SO / Documentation בתדירות גבוהה כל כך מה שמביא לפקפק ביכולותיי

יתכן שזו לא הדרך היעילה ביותר לפתור את המשימות שלך.

האם אתה משתמש IDE? האם עמיתייך משתמשים בכאלה? מכיוון שניתן למחוק את הפרטים הקטנים האלה לתכונת ההשלמה האוטומטית של IDE. השימוש בהשלמה אוטומטית יעיל יותר מלהעביר את תשומת לבך לדפדפן ולחפש שם תשובה.

אם עמיתייך משתמשים בהשלמה האוטומטית של ה- IDE שלהם ואתה משתמש בגוגל במקום זאת, זה יכול להראות לא מקצועי - לא בגלל שאתה מתייעץ עם מסמכים אלא בגלל אתה עושה את זה בצורה לא יעילה.

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

שלט בכלים שלך והראה ביצועים, זה מקצועי.

אחרים סיפקו תשובות מוצקות, אך אף אחד לא ממש מתייחס לחזית זו; הדגשה מודגשת היא שלי:

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

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

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

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

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

FWIW אני עושה עבודות מחשב כבר למעלה מ- 20 שנים ורק בשנים האחרונות אני ממש יכול לדמיין פתרונות ראש בלי לכתוב שורת קוד. זו מיומנות שאליה צומחים ולא ניתן לדרוש ממישהו לפי דרישה.

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

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

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

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

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

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

קח למשל את הדואר () פונקציה. האם ידעת ...

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

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

• בעת שליחת דואר, הדואר חייב להכיל כותרת From. ניתן להגדיר זאת באמצעות הפרמטר נוסף_כותרות , או להגדיר ברירת מחדל ב php.ini.

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

• ה- $ ל- הפרמטר חייב להיות תואם ל RFC 2822.

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

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

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

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

עם זאת ישנם מקרים שאני אשקול להיות שימוש לרעה בתיעוד.

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

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

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

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

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

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

נדיר שיש בעיה שאני לא מצליחה להבין בעצמי. אבל זה לוקח זמן. בהתחשב בבחירה בין לקחת שעה להבין את עצמי לבין חמש דקות להשתמש בגוגל, ההוצאות על השעה אינן מקצועיות.

יש לך כבר כמה תשובות טובות, אבל תן לי להוסיף טוויסט קטן ...

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

לא משתמש בתיעוד

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

רק הדרכות?

אנשים מחפשים לעתים קרובות אחר הדרכות או קטעי קוד. כולל SO, בלי אי פעם התייחס לתיעוד, לא מרגיז אותי עד אין קץ. התנהגות זו היא מלכודת ענקית, לדעתי. זה מוביל לסוג של תכנות שמונע על ידי "ידע" אפוי למחצה, שרירותי, ולא שיטתי. אותם מתכנתים נוטים בסופו של דבר עם הרבה דעות קדומות. מכאן נאגטס כמו "לעולם אל תשתמשו git rebase ", "לעולם אל תשתמשו ב- לא ב- ב- SQL", "תמיד תעשו XXX", "אף פעם לא YYY". הם יתקשו מאוד לחשוב מחוץ לקופסה, להעלות רעיונות חדשים, ליצור אינטואיציה כיצד לבנות את היישומים שלהם וכל הדברים האלה שמרכיבים מפתחים מעולים.

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

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

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

תיעוד

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

אני לא מוצא את זה מוזר לקרוא, למשל, את הקלאסיקה הישנה של C ++ (נייר ישן וטוב), כנופיית ארבע דפוסי העיצוב, המדריך (גרסה מקוונת) של "תכנות אודם", דפי האדם של פרל, כל הכבוד, ספר Git, RFC מסוימים, HTML / XML / וכו '. מפרטים וכן הלאה מקדימה לאחור. הייתי עושה ועשיתי את זה אפילו בזמני הפנוי והייתי, בכנות, מצפה לכך מכל מתכנת ששווה את המלח שלו / ה (כמובן, תלוי עם מה הם עובדים). אני גם מודע היטב לכך שאני (לפחות בחברות בהן עבדתי בעשורים האחרונים) די לבד עם דעה זו.

(הערה: ברור שאתה לא צריך לשנן ענק רשימות של הפניות ל- API, אך לפחות מבריקות עליהן כדי לראות מה זמין ומה נראה "רוחו" של ה- API.)

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

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

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

אני לעג לרוב על השימוש ב- Stack Overflow / תיעוד בתדירות גבוהה כל כך

דעותיהם של אנשים אחרים לגביך אינן מגדירות את אתה , הן רק הגדר אותם

האם שימוש בתיעוד כמפתח גורם לי להראות לא מקצועית?

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

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

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

אם אני צריך לכתוב קוד במהלך ראיון לעבודה אחרת אני מניח שאתה לא צריך להשתמש בתיעוד

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