گذشته ی نامعلومی که همه ازش حرف میزنن

تقریبا حدود دو سال پیش مسیر زندگیم رفت سمت برنامه نویسی لینوکس و شبکه تو کامیونیتی هایی فعال بودم و با افرادی در این مسیر آشنا شدم شروع کردم به یادگیری و درگیری با چیزایی مثل پایتون لینوکس سیسکو و ....

اوایل مسیر سخت بود چون سردر نمی اوردم به هر چیزی میرسیدم میگفتم واوو اینجا چیه و کلی درگیری با اون موضوعات که یاد بگیرم چخبر شده و یه سری داستان دیگه ( زیاد زندگانی نکنیم بحث رو)

همیشه تو صبحتا و کامیونیتی ها از موضوعی صحبت میشد که خب همه بهش معتقدن ولی خیلی کم انجام میشه و چرا انجام نمیشه هم کلی دلیل ( من سخت یادگرفتم بقیه هم باید سخت یادبگیرن , نباشه خوبه چون خودم میدونم اونجا چکار کردم و بعدا شرکت میخواد منو و دلیل عمده "حال ندارم"! و کلی چیز دیگه حالا میپرسین اون موضوع چیه ؟

داکیومنت

وارد مباحث تخصصی تر شدم (شبکه , سیسکو , لینوکس) همیشه بهم توصیه شد که هر کاری میکنی داکیومت کن ولی وقتی تو محیط واقعی رفتم دیدم هیچی داکیومت نداره هیچی معلوم نیست و این موضوع باعث میشده که افراد ماه ها وقت رو برای کاری که تو شاید نهایت یک ماه میشد انجام داد.

حالا چند موضوع پیش میاد:

• داکیومت کردن (کد و هرچی) زمان بره
• داکیومت باعث میشه کار من رو یکی بخونه و بتونه انجام بده و دیگه اون شرکت منو نخواد
• من سخت یاد گرفتم چرا باید راحت در اختیار کسی بزارم
• حال ندارم!

خب اینا دلیل هاییه که شنیدم دیدم و خب در حدی بعضی هاشو تو شرایط کار واقعی اینجا در مواقعی قبول کنم.
اینجا قراره از تجربیات خودم و کسایی که میگفتن بخاطر اینکه داکیومنتی نداشتن وقتی تو کاری رفتن باعث شده به مشکل بخورن و دوباره از اول موضوعات رو بخونن صحبت کنیم.

ولی چه اتفاقی میوفته که داکیومت باعث بهتر شدن زندگی میشه کار که خوب داره پیش میره و نهایت انجام میشه

تجربیات!

• چند روز پیش برای فرستاده شدم یک سازمانی و خب گفتن بهم که سرویسمون مثل همیشس و برو کارشو انجام بده منم رفتم شاد و خوشحال کارای اولیه رو انجام دادم بعد دیدم نمیشه یه جا کار میلنگه با کلی بررسی و زنگ به جاهای دیگه فهمیدم اون سرویس مثل همیشه نیست و کارای دیگه ای باید روش انجام میشده که نشده و خب ۸ ساعت درگیری بودم و درست نشد و فرداش دوباره رفتم و انجام دادم.
  داستان از این قرار بود که قبل از من سه نفر دیگه اونجا رفته بودن و خب به من نگفته بودن که ازشون بپرسم اونجا کارش تا کجا پیشرفته بوده و کلا کسی هم نمیدونست...
  اینجا کاری که ۲ روز طول میکشید حتی با وجود پیدا کردن مشکلاتش و غیره در ۳ هفته انجام شد و چرا
  چون اطلاعات درستی از سرویس و کاری که بقیه هم انجام داده بودن نداشتن و حتی سازمانی که باهاش در ارتباط بودم هم چیزی نمیدونست و باعث شد من اونجا به معنای واقعی کشف کنم که چه اتفاقی افتاده
• داشتم یک سناریوی روتینگ ساده (RIP) که خب برای خیلیا کار ۲ دقیقس انجام میدادیم من از همه کندتر انجام دادم و خب غر هم شنیدم و بعدا این تاخیر مشخص شد؛‌ همه به ارور خوردن و باید troubleshooting انجام میدادن و خب من داکیومت کارمو داشتم و میتونستم مسیرم رو ببینم و سریع تر این انجام شه.
• به یک سازمان دیگه اعزام شدم و خب دیتاسنتری که از دور ببینیم خیلی خوشحال و خرسند میشیم ولی وقتی من ازش اومد بیرون از شدت خستگی چشام درست کار نمیکرد و خب موضوع چی بود؛
  مواجه شدم با یه سری سوییچ و روتر و یکی از تسک هارو انجام دادم خیلیم ساده بود و تسک بعدی دایکومت کردن دوتا از رک ها بود (شاید بپرسید دیتاسنتر ها خب لیبل دارن و داکیومتنش موجوده) ولی واقعیت این بود که آره لیبل داشتن ولی نه همش! داکیومت فقط زمانی بود که راه اندازی شده و به اصطلاح شیک و تمیز بود همه چی ولی با کلی دم دستگاه داکیومت نشده مواجه بودم و خب این کار ۳ ساعت زمان برد و باید انجام میشد.
  ( تقریبا جایی که من باهاش مواجه بودم میشه گفت تمیز ترین و با نظم ترین بود! دیگه بقیه چین)
  

اینها تجربیات من در دنیای واقعی ای بود که قبل از مواجه شدن با اینها رویای این رو داشتم که ایول همه چی منظم و تمیز و با قاعده پیش میره.
حالا شاید به خودتون بگید خب خیلی از جاها این طورین کاری مگه میشه کرد به ما چه یا اصلا داکیومت من رو کی نگاه میکنه اصلا یا من دارم کارو انجام میدم پولمو میگیرم چرا باید داکیومت کنم و از این قبیل.

ولی موضوع اینجا مشکل ساز میشه که از سرویس یا کد شما یکی دیگه هم میخواد استفاده کنه و اگه مستند شده باشه و طرف سریع تر بفهمه از یه طرف دیگه یه سرویس یا کد دیگه سریع تر انجام میشه...

این پست رو بر اساس تجربیات و مشاهداتم نوشتم البته خیلی بیشتر از این قرار بود باشه ولی خب اگه بخوایم جزئیات این داستان رو ببینیم خیلی گسترده تر میشه.
در آخر هم اینکه داکیومت بنویسید کار , کد , توپولوژی ها و هرچی که دارید وقت بزارید روش بدونید کار بیهوده ای نیست چون باعث سرعت بخشیدن به کار ها و خوشحال شدن خیلیا میشید و موضوعی نیست که شمارو از کار بیکار کنه چون اگه کسی واقعا در حوزه ای تخصص داشته باشه حتی اگه داکیومت کارتونم کس دیگه ای بخونه نمیتونه بفهمه و موضوع اصلی و جزئی رو درک کنه , عموما از داکیومت ها کاری رو یاد میگیریم ولی میدونیم داکیومت ها باعث فهمیدن ۱۰۰ درصد یک تکنولوژی یا تخصصی نمیشه تجربه و زمان نیازه.

اگر تجربه ای دارید و راه حل مناسبی برای کوتاهی زمان مستند سازی در برنامه نویسی شبکه یا هرچیزی خوشحال مشیم از طریق توییتر یا تلگرام در ارتباط باشیم.