كثير من المبتدئين في البرمجة يواجهون صعوبة في فهم وقراءة الوثائق (documentation)📄 عند البحث عن مشكلة معينة ومحاولة الوصول لحلها.
في هذا الثريد نصائح ذهبية تساعدك تفهم الوثائق بشكل افضل..✨👇🏻
في هذا الثريد نصائح ذهبية تساعدك تفهم الوثائق بشكل افضل..✨👇🏻
في البداية خلونا نتفق أن التوثيق ماهو إلا "وصف مُفصّل" لطريقة عمل تقنية أو لغة معينة تمت كتابتها من قِبل الاشخاص المطورين لها.📄
في الغالب وُجدت هذه الوثائق للرجوع لها وقت الحاجة، وعشان ماتضطر تحفظ كل صغيرة وكبيرة خاصة بالتقنية أو اللغة الي تستخدمها.✅
في الغالب وُجدت هذه الوثائق للرجوع لها وقت الحاجة، وعشان ماتضطر تحفظ كل صغيرة وكبيرة خاصة بالتقنية أو اللغة الي تستخدمها.✅
لذلك، حتى تفهم الوثائق بشكل صحيح وتأخذ الزبدة منها، تابع النصائح في هذا الثريد:👇🏻✨
1- افهم الجزء الاول في الوثائق (Get Started):✨
أغلب الوثائق تحتوي في بدايتها على القسم هذا بمسميات مختلفة مثل (Get Started, Quick Start, Guides) وغيرها..
هذا الجزء مهم جدًا ويعتبر مدخل وبداية لفهم اللغة أو التقنية، ويحتوي عادة على أمثلة بسيطة وصغيرة لكيفية استخدامها.
أغلب الوثائق تحتوي في بدايتها على القسم هذا بمسميات مختلفة مثل (Get Started, Quick Start, Guides) وغيرها..
هذا الجزء مهم جدًا ويعتبر مدخل وبداية لفهم اللغة أو التقنية، ويحتوي عادة على أمثلة بسيطة وصغيرة لكيفية استخدامها.
🔴🔴
البعض قد يُهمل هذا القسم ويذهب مباشرة للنقطة المطلوبة من غير فهم واضح للبداية.
نصيحتي لك: الفهم هو الاولوية.👌🏻✅
البعض قد يُهمل هذا القسم ويذهب مباشرة للنقطة المطلوبة من غير فهم واضح للبداية.
نصيحتي لك: الفهم هو الاولوية.👌🏻✅
2- التركيز على النصائح المتنوعة.🔎
الوثائق عادةً تحتوي على بعض العلامات الدلالية حتى تساعدك في فهم طبيعة عمل هذا الجزء .
ومن بعض الامثلة على هذه العلامات:
- علامة $ قبل الاكواد تدل على أن هذا السطر البرمجي من المفترض تشغيله.
الوثائق عادةً تحتوي على بعض العلامات الدلالية حتى تساعدك في فهم طبيعة عمل هذا الجزء .
ومن بعض الامثلة على هذه العلامات:
- علامة $ قبل الاكواد تدل على أن هذا السطر البرمجي من المفترض تشغيله.
- تمثيل التسلسل الهرمي للملف في الوثائق يوضح لك الطريقة الصحيحة الي تبني فيها تسلسل الملفات في مشروعك و ايش هيا الملفات الفرعية والملفات الرئيسية في المشروع.👇🏻
- عند استخدامك لأي Api في مشروعك، الموقع الخاص بهذا الـApi يُوفر أمثلة لكيفية استخدامه والنتيجة النهائية من استخدامه.
مثال موقع jsonplaceholder👇🏻
مثال موقع jsonplaceholder👇🏻
4- تحقق من اصدار التوثيق📄
عند تطوير لغة أو تقنية معينة من الطبيعي عمل تحديثات مستمرة لها، لذلك لابد أنك تتحقق من اصدار التوثيق الي تقرأه لأن كل نسخة أو تحديث قد تحتوي على ميزات جديدة أو ميزات تم حذفها من النسخ السابقة.
عند تطوير لغة أو تقنية معينة من الطبيعي عمل تحديثات مستمرة لها، لذلك لابد أنك تتحقق من اصدار التوثيق الي تقرأه لأن كل نسخة أو تحديث قد تحتوي على ميزات جديدة أو ميزات تم حذفها من النسخ السابقة.
- مثال من توثيق Bootstrap✨
نلاحظ أن بعض الكلاسات تم تغيير مسمياتها مثل الكلاس rounded-right في الاصدار الخامس صارت rounded-end.
نلاحظ أن بعض الكلاسات تم تغيير مسمياتها مثل الكلاس rounded-right في الاصدار الخامس صارت rounded-end.
3- تعلّم قراءة الكود البرمجي داخل الوثائق.🔎
الوثائق تحتوي على شرح لكل جزئية خاصة باللغة عن طريق وضع امثلة أو كود برمجي.
لذلك، حاول تحلل هذي الامثلة والاكواد، جربها، اختبرها بنفسك، غيّر بعض الاشياء فيها وحاول تشغيلها مره اخرى.🔄
الوثائق تحتوي على شرح لكل جزئية خاصة باللغة عن طريق وضع امثلة أو كود برمجي.
لذلك، حاول تحلل هذي الامثلة والاكواد، جربها، اختبرها بنفسك، غيّر بعض الاشياء فيها وحاول تشغيلها مره اخرى.🔄
🔴🔴
البعض قد يأخذ الاكواد نسخ لصق من دون فهمها وتحليلها.
نصيحتي لك:
لاتنسخ الكود الا لما تفهم بالضبط ايش طريقة عمله ووظيفته والنتيجة النهائية من تطبيقه.✅
البعض قد يأخذ الاكواد نسخ لصق من دون فهمها وتحليلها.
نصيحتي لك:
لاتنسخ الكود الا لما تفهم بالضبط ايش طريقة عمله ووظيفته والنتيجة النهائية من تطبيقه.✅
5- استخدم مصادر متعددة مع الوثائق.✔️
الوثائق قد لاتكون صديق حميم جدًا للمبتدئين😅،لأن مطوّرها غالبًا افترض أن القراء يعرفون بالفعل النقاط الاساسية لهذي اللغة أو التقنية.
لذلك لو كنت مبرمج مبتدئ وحاب تعتمد فقط على الوثائق للتعلّم، حاول استخدام مصادر اخرى مع الوثائق بشكل تزامني.
الوثائق قد لاتكون صديق حميم جدًا للمبتدئين😅،لأن مطوّرها غالبًا افترض أن القراء يعرفون بالفعل النقاط الاساسية لهذي اللغة أو التقنية.
لذلك لو كنت مبرمج مبتدئ وحاب تعتمد فقط على الوثائق للتعلّم، حاول استخدام مصادر اخرى مع الوثائق بشكل تزامني.
في النهاية..✨
نصيحتي لكل مبرمج أيًا كان مستواه:
"لا تُهمل القراءة"
لأنك مع كثرة القراءة لمصادر متعددة ووثائق ومقالات تعليمية، راح تكتشف وتفهم الموارد والطرق الي تناسبك وتعطيك اقصى فائدة تعليمية.✅
نصيحتي لكل مبرمج أيًا كان مستواه:
"لا تُهمل القراءة"
لأنك مع كثرة القراءة لمصادر متعددة ووثائق ومقالات تعليمية، راح تكتشف وتفهم الموارد والطرق الي تناسبك وتعطيك اقصى فائدة تعليمية.✅
جاري تحميل الاقتراحات...