فرهاد ناصری زاده 🐍
داکیومنت بخونیم یا توتوریال ببینیم؟ مسئله این است..
خیلیا رو دیدم با یه دید تعصبی به این قضیه نگاه می‌کنن! باور کنید این کار از بیخ اشتباس. شما قراره یاد بگیرید. صد البت مهمه از کجا و به چه شیوه‌ای یاد بگیرید ولی حالا بین خودمون باشه.. داکیومنت بخونیم یا توتوریال و ویدئو تماشا کنیم؟! اصلا کدوم بهتره؟!
واسه پاسخ به این سوال، اینکه بدونیم داکیومنت چیه خیلی حائز اهمیته. داکیومنت (Document) یا گاها خیلی جاها ممکنه بصورت مختصر (Docs) هم نوشته شه، یه کتابچه جامع هست که به شکل ساختاربندی‌شده‌ای، اجزای فریم‌ورک، کتابخانه یا زبان رو مورد بررسی قرار داده. منظورم از اجزا همون Components هست یعنی کلاس ها، توابع، متدها، ثبات ها و..
خیلی از داکیومنت ها با محوریت مثال همراه هستن یعنی داخل خودشون، بعد از تشریح و توضیح یک کلاس، یه مثال کوچیک هم از شیوه ساختن یک آبجکت از اون کلاس قرار دادن ولی خب زیاد مرسوم نیست که داکیومنت ها همراه با مثال باشن. نکته بعدی اینه که داکیومنت ها گاها ممکنه از جمع‌آوری DocStringها باشن. منظورم همون شبه-کامنت ها اول تشریح متدها، کلاس‌ها و توابع هست. این نوع کامنت‌ها (تعریف‌ها) نام‌های مختلفی داره. مثلا توی جاوا بهش میگن JavaDoc و گاها مکانیزم‌ها و ابزارهایی اون بیرون موجوده (مثل SphinX در پایتون) که بهتون کمک میکنه این نوع کامنت‌ها رو طبق یه سری کانونشن (Convention) خاص، ساختاربندی کنید و ازشون نسخه ePub، PDF یا حتی HTML اکسپورت بگیرید برای آپلود روی اینترنت. (جاهایی هستن که میشه داکیومنت پروژتون رو بصورت رایگان روشون آپلود کنید مثل readthedocs.io)
من خودم شخصا موقعی میرم سراغ داکیومنت که بخوام از ماهیت یه موجودیت بیشتر باخبر شم. اینکه یه کلاس دقیقا چطور کار میکنه یا چه آپشن‌های اضافی داره الی آخر..
توتوریال هم که خیلیامون باهاش آشناییم. نمونش کورس‌ها و دوره‌هایی که تماشا کردید که بیشتر یا جنبه آشناسازی دارن یا دیپ شدن روی یه قضیه. اکثر توتوریال‌ها با مثال همراه هستن و پروژه محورن و این موضوع باعث شده خیلی مورد استقبال قرار بگیرن. اگه میخواید یه موضوع رو تازه شروع کنید، پیشنهاد میشه یه دوتا کلیپ اول ازش ببینید، دوتا مثال ازش تماشا کنید شاید اصلا از یادگیریش منصرف شدید. اگه واقعا میخواید دیپ شید روی یه موضوع، برید سمت داکیومنتش و کتاب‌هایی که درباره اون موضوع نوشته شده.
.
یه نکته پایانی بگم!
شما آزادی به هر روشی که دوست داری یاد بگیری. گاها آدمی با شنیدن، دیدن یا حتی تجسم کردن یاد میگیره. یه نفر اگه یه داستان رو بخونه خوب میتونه نتیجه بگیره.. یه نفر اون داستان رو حتما باید بصورت فیلم تماشا کنه.. سعی کنید اون مدل یادگیری که بیشتر واسه شما جواب میده رو پیدا کنید و به اون شیوه یاد بگیرید ولی در کنارش مطالعه هم داشته باشید. (چه به فارسی چه زبان دیگه‌ای)
نویسنده در نوشتن هیچ محدودیتی نداره. نهایت این کتابش پر شد، باقیشو جلد بعدی می‌نویسه. واسه همین میتونه ریز و درشت یه قضیه رو مورد بحث قرار بده. ولی توتوریال ها و دیگر مدیا ها، محدودیت زیاد دارن.
یه نویسنده واسه کتابش ممکنه سالها زمان بذاره.. ولی یه Content Creator شاید نهایت یه هفته زمان بذاره همون موضوع رو در ۱۵ دقیقه توضیح بده.
امیدوارم موفق باشین. ❤️
20 · 1.6K ·