متى كانت آخر مرة قرأت فيها وثائق تقنية سلسلة الكتل دون أن تفقد أعصابك، منذ متى كان ذلك؟
تبدو وثائق سلسلة متعددة مثل “متاهة التشفير”: عند فتح شاشة مليئة بالمصطلحات المتفجرة، تحتاج إلى البحث عن دليل نشر عبر 5 قوائم، وبعد جهد طويل ترى مثال الكود، وعند النسخ واللصق يحدث خطأ - في النهاية، لا يسعك سوى أن تحمل رأسك المليء بالأسئلة، وتذهب إلى Discord لتصبح “شخص يستجدي المساعدة”.
لكن وثائق Linea على docs.linea.build، قد حولت “قراءة الوثائق” إلى تجربة ممتعة مثل مشاهدة مقاطع الفيديو التعليمية. لم تعتبر الوثائق “كتيبًا تقنيًا”، بل تعاملت معها كـ “واجهة منتج” تتحدث إلى المستخدم، من سرعة التحميل إلى تصميم المحتوى، كل تفصيل يقول: “أنا أفهم مشكلتك، سأساعدك في حلها.”
منذ اللحظة التي تفتح فيها الصفحة، ستلاحظ اختلافها:
التحميل سريع لدرجة أنك قد تظن أنك لم تنقر أصلًا: فالتسريع العالمي عبر CDN يجعل صفحات التوثيق تُفتح فورًا، حتى في الأماكن التي يكون فيها الاتصال بالإنترنت متوسطًا، دون أن تحدّق في شاشة فارغة بانتظار التحميل؛
التنقل أشبه بـ«مساعد تسوق ذكي»: لا فهرس يخلط كل شيء في «قدر واحد»، بل قوائم تنقل مقسمة بحسب الفئة: «المطورون / المستخدمون العاديون / شركاء المنظومة». هل تريد تحويل ETH عبر الجسر؟ انقر على «دليل المستخدم» لتجد الشرح في 3 خطوات. هل تريد نشر عقد بصفتك مطورًا؟ ستجد في «أدوات المطورين» كل شيء، من إعداد البيئة إلى أمثلة الشيفرة، دون إضاعة الوقت في محتوى لا علاقة له بما تبحث عنه؛
تعدد اللغات أشبه بـ«مترجم يهتم بك»: فالتوثيق يدعم الصينية والإنجليزية افتراضيًا، وحتى رسائل الخطأ مترجمة وموطّنة، فلا تعود مضطرًا إلى الحيرة طويلًا أمام عبارة «invalid signature» متسائلًا إن كان الخطأ في المفتاح الخاص أم في اختيار الشبكة.
والأروع أنها حوّلت «التوثيق الثابت» إلى «مختبر تفاعلي»:
يوجد أسفل كل واجهة API زر «جرّب الآن» — فلا حاجة لإعداد بيئة محلية؛ أدخل المعلمات في التوثيق مباشرةً وانقر للاختبار، وستظهر النتيجة فورًا، بل وحتى رسائل الخطأ تتضمن «رابطًا للحل». فعلى سبيل المثال، إذا أدخلت عنوان أصل خاطئًا عند استدعاء API للجسر بين السلاسل، فلن يكتفي التوثيق بالتنبيه إلى «خطأ في التنسيق»، بل سينقلك أيضًا إلى «أداة البحث عن عناوين الأصول» لتجد العنوان الصحيح بسرعة.
أما للمبتدئين، فتصميم «رحلة التعلّم» ضرورة لا غنى عنها:
انقر على «Get Started» لتدخل مباشرة في «وضع التعلّم خطوة بخطوة»:
الخطوة الأولى، «تثبيت المحفظة»: لا يكتفي التوثيق بتوفير رابط تنزيل MetaMask، بل يرفق أيضًا مقطعًا متحركًا يشرح «كيفية التبديل إلى شبكة Linea»، بل ويذكر مسبقًا ضمن التنبيهات «ما العمل إذا نسيت الاحتفاظ بنسخة احتياطية من العبارة الأولية»؛
الخطوة الثانية، «نقل ETH عبر الجسر»: تُبرز كل خطوة لتحويل الأموال من الشبكة الرئيسية إلى Linea باللون الأحمر، كما تقارن بين «الجسر الرسمي والجسور التابعة لجهات خارجية» من حيث المزايا والعيوب، لتساعدك على تجنب المشكلات؛
الخطوة الثالثة، «نشر العقد»: تتضمن الصفحة بيئة IDE عبر الإنترنت، مع الشيفرة الكاملة المكتوبة بلغة Solidity. انقر على «تشغيل» لمتابعة تقدم نشر العقد، وبعد نجاحه ستتعلم أيضًا «كيفية التحقق من حالة العقد في مستكشف الكتل»؛
لا توجد طوال الرحلة أي خطوات محذوفة على أساس «من المفترض أنك تعرفها»؛ حتى «إعداد البيئة»، أكثر ما يخشاه المبتدئون، يتولّى التوثيق إرشادك إليه، وكأن خبيرًا تقنيًا يجلس بجانبك ويعلّمك خطوة بخطوة.
حتى أنه جهّز لك مخرجًا «عند مواجهة مشكلة»:
تتضمن نهاية كل صفحة «وحدة تواصل مع المجتمع» — فإذا لم يتضح لك الأمر بعد قراءة التوثيق، فانقر على أيقونة Discord للانتقال مباشرةً إلى قناة النقاش ذات الصلة، حيث سبق لمطورين آخرين مشاركة حلول لمشكلات مشابهة. كما تضم روابط Reddit ملاحظات عن «أهم نقاط التوثيق» أعدّها المستخدمون لتوفير وقتك.
قال أحد المبتدئين في Web3 على أحد المنتديات: «كنت أقرأ توثيق سلاسل أخرى، وبعد نصف ساعة أكاد أستسلم. أما الآن، فمع توثيق Linea، وجدت نفسي قد أكملت دون أن أشعر خطوات نشر تطبيق لامركزي DApp من الصفر، بل واتبعت نصائح التحسين الواردة فيه لخفض رسوم Gas بنسبة 20% — إنها المرة الأولى التي أشعر فيها أن التوثيق التقني يمكن أن ’يفيد حقًا‘».
يكمن السر في أن Linea تصقل «تجربة التوثيق» وتجعلها جوهر المنتج:
استعانوا بفريق كتابة تجربة المستخدم على مستوى Stripe، فحوّلوا مفاهيم معقدة مثل «عملية التحقق من ZK-SNARKs» إلى شروحات بسيطة، كأنها: «نضع ختمًا مشفّرًا على المعاملة، ولا تحتاج الشبكة الرئيسية إلا إلى التحقق من الختم، لا الاطلاع على المحتوى». واستلهموا منطق Vercel في توثيقها، القائم على «التركيز على المشكلة»، فوضعوا «كيفية حل مشكلة فشل نشر العقد» في مكان بارز ضمن «دليل النشر»، بدلًا من إخفائها في «الأسئلة الشائعة».
في قطاع Web3، تتعامل مشاريع كثيرة مع التوثيق بوصفه «ملحقًا لإنجاز المهمة»، فتملؤه بعبارات «صحيحة لكنها بلا فائدة». أما Linea، فتراه «البوابة الأولى التي يدخل منها المستخدم إلى منظومتها» — فعندما تبذل سلسلة كل هذا الاهتمام حتى في «تعليمك كيفية استخدامها»، ستعرف أن استقطابها 420 مشروعًا ضمن المنظومة و1.3 مليون مستخدم لم يكن مصادفة أبدًا.
ففي النهاية، فهم المستخدم حقًا يعني أن تجعل «الأمور المزعجة» مريحة له.@Linea.eth #Linea $LINEA
