یونٹ 8 / 11

دستاویزی اور تکنیکی تحریر: وائٹ پیپر، نیٹ اسپیک اور یوزر گائیڈ

فائدہ:

  • وائٹ پیپر تیار کرنے، نیٹ اسپیک، تکنیکی-سادہ ترجمہ اور خطرے کے انکشاف میں محفوظ طریقے سے مصنوعی ذہانت کا استعمال کرنے کے قابل ہونا اور یہ سمجھنا کہ یہ سب سے زیادہ نتیجہ خیز فیلڈ ہے۔
  • ہر تکنیکی دعوے کی اصل کوڈ کے ساتھ تصدیق کرنے اور غلط دستاویزات کے خطرے سے بچنے کے لیے مبالغہ آرائی اور وارنٹی زبان کو ہٹانے کی اہلیت
  • خطرات کو ایمانداری سے قبول کرنے کی صلاحیت، 'مالی مشورہ نہیں' انتباہ اور دستاویزی کوڈ کی مستقل مزاجی

ویب 3 میں دستاویزات عیش و عشرت نہیں، بلکہ سیکورٹی اور اعتماد کا معاملہ ہے۔ سمارٹ کنٹریکٹ کے ساتھ بات چیت کرنے سے، صارف اپنی اصلی رقم کو خطرے میں ڈالتا ہے۔ اگر وہ نہیں سمجھتا کہ وہ کیا کر رہا ہے، تو وہ دھوکہ دہی کے لیے کھلا ہے۔ آڈیٹر محفوظ طریقے سے کوڈ کا جائزہ نہیں لے سکتا جو اچھی طرح سے دستاویزی نہیں ہے۔ اس یونٹ میں، ہم اس علاقے کا احاطہ کرتے ہیں جہاں AI سب سے زیادہ قابل اعتماد اور موثر ہے: دستاویزات اور تکنیکی تحریر۔ وائٹ پیپر سے لے کر کوڈ کے تبصروں تک، صارف کی رہنمائی سے لے کر خطرے کے انکشافات تک، AI یہاں ایک حقیقی قوت ضرب ہے — جب تک کہ درستگی کی انسانی طور پر نگرانی کی جائے۔

ویب 3 دستاویزات کی اقسام

  • وائٹ پیپر/لائٹ پیپر: بنیادی دستاویز جو منصوبے کے وژن، میکانزم اور ٹوکنومکس کو بیان کرتی ہے۔
  • تکنیکی دستاویزات: کنٹریکٹ انٹرفیس، ڈویلپرز کے لیے انضمام گائیڈ۔
  • NatSpec (Ethereum Natural Language Specification — Standed in-code comment format in Solidity جو یہ بتاتا ہے کہ فنکشنز کیا کرتے ہیں): کوڈ میں سرایت شدہ دستاویزات، انسان اور ٹول دونوں کے ذریعہ پڑھی جاتی ہیں۔
  • یوزر گائیڈ: سادہ متن جس میں آخری صارف کو "استعمال کیسے کیا جائے، کیا خطرات ہیں"۔
  • ڈس کلیمر: قانونی اور اخلاقی طور پر مطلوبہ انتباہات۔

ان اقسام کے ساتھ ایک عام مسئلہ: ڈویلپر لکھنا پسند نہیں کرتے اور اکثر اسے آخری لمحے تک چھوڑ دیتے ہیں۔ AI بالکل اس خلا کو پُر کرتا ہے۔

کیوں دستاویزات AI کا سب سے محفوظ علاقہ ہے۔

دستاویزات میں غلطی کی قیمت آڈیٹنگ کے مقابلے میں کم ہے: ایک غلط جملہ درست کیا جاتا ہے، کوئی پیسہ نہیں اڑتا (براہ راست)۔ مزید برآں، زبان کی تیاری میں AI قدرتی طور پر مضبوط ہے۔ لہذا AI یہاں موثر اور نسبتاً محفوظ ہے۔ لیکن دو اہم خطرات باقی ہیں:

  1. جھوٹا تکنیکی دعوی: AI غلط بیانی کر سکتا ہے جو کوڈ کرتا ہے۔ یہ صارف کو گمراہ کرتا ہے اور سیکیورٹی کا خطرہ بن سکتا ہے (جب تک یہ نہ کہے کہ "یہ فنکشن آپ کے فنڈز کی حفاظت کرتا ہے" اور ایسا نہیں کرتا)۔
  2. Hyperbole/مارکیٹنگ کی زبان: AI ایسی زبان تیار کر سکتا ہے جو کسی پروجیکٹ کو محفوظ یا منافع بخش بنائے۔ یہ ایک اخلاقی اور قانونی مسئلہ ہے۔
احتیاط: دستاویزات کوڈ کی وضاحت کرتی ہے۔ یہ خود کوڈ نہیں ہے۔ ہر تکنیکی دعویٰ جو AI لکھتا ہے ("ایسا ہوتا ہے"، "جو برقرار رکھتا ہے") کی اصل کوڈ کے خلاف تصدیق ہونی چاہیے۔ غلط دستاویزات درست کوڈ سے زیادہ خطرناک ہو سکتی ہیں کیونکہ صارف دستاویزات پر بھروسہ کرتا ہے۔

دستاویزات میں AI کے استعمال کی پرتیں۔

1. NatSpec نسل۔ AI ایک موجودہ فنکشن کو پڑھتا ہے اور NatSpec تشریح کا مسودہ تیار کرتا ہے: یہ کیا کرتا ہے، اس کے پیرامیٹرز کیا ہیں، یہ کیا واپس کرتا ہے۔ یہ معائنہ اور دیکھ بھال کو آسان بناتا ہے۔

2. تکنیکی-سادہ ترجمہ۔ AI ایک پیچیدہ طریقہ کار کا زبان میں ترجمہ کرتا ہے جسے آخری صارف سمجھ سکتا ہے — Web3 کی سب سے بڑی ضروریات میں سے ایک۔

3. وائٹ پیپر کا خاکہ اور ساخت۔ AI کنکال اور سفید کاغذ کے حصے تیار کرتا ہے۔ مواد کی درستگی انسانی ہے۔

4. کثیر لسانی اور سطح کی ایڈجسٹمنٹ۔ AI ترکی اور انگریزی دونوں میں تکنیکی اور سادہ دونوں طرح کا مواد تیار کر سکتا ہے۔

کمزور فوری / مضبوط اشارہ

کمزور اشارہ:

اس منصوبے کے لیے ایک وائٹ پیپر لکھیں۔

AI اصل طریقہ کار کو جانے بغیر مبالغہ آمیز، ممکنہ طور پر غلط، اور مارکیٹنگ سے بھری کاپی بناتا ہے۔

طاقتور اشارہ:

آپ کا کردار: Web3 تکنیکی مصنف۔ ذیل میں پروجیکٹ کا حقیقی طریقہ کار، ٹوکنومکس اور کوڈ ہے۔ صرف اس معلومات پر مبنی وائٹ پیپر کا مسودہ لکھیں۔ قواعد: - مبالغہ آرائی نہ کریں، "ضمانت شدہ منافع"، "مکمل طور پر محفوظ" وغیرہ جیسے جملے استعمال نہ کریں۔ من گھڑت باتیں شامل نہ کریں۔- ایک "خطرات" سیکشن شامل کریں جو خطرات کو واضح طور پر بیان کرتا ہے۔- ایک انتباہ شامل کریں "یہ مالی مشورہ نہیں ہے۔" کسی بھی معلومات کو نشان زد کریں جس کے بارے میں آپ کو یقین نہیں ہے یا جو میرے پاس نہیں ہے [TO BE FILLED]۔

چار کاپی کرنے کے قابل ٹیمپلیٹس

1) نیٹ اسپیک نسل:

درج ذیل فنکشن پر معیاری NatSpec تبصرے لکھیں: @notice (کیا کرتا ہے، سادہ)، @dev (تکنیکی نوٹ)، @param اور @return۔ صرف وہی لکھیں جو کوڈ اصل میں کرتا ہے؛ ایسا سلوک شامل کرنا جو کوڈ میں نہیں ہے۔ اس اثر کو جھنڈا لگائیں جس کے بارے میں آپ کو یقین نہیں ہے۔

2) تکنیکی-سادہ ترجمہ:

اس طریقہ کار کی سادہ ترکی زبان میں وضاحت کریں جسے ایک کرپٹو نوآموز صارف سمجھ سکتا ہے: یہ کیا کرتا ہے، صارف کو کیا کرنا چاہیے، کیا خطرات ہیں؟ مبالغہ آرائی؛ سیکورٹی کی کوئی ضمانت نہیں. خطرات کو نہ چھپائیں، انہیں سامنے لائیں.

3) خطرہ/انتباہی سیکشن:

اس پروجیکٹ کے لیے ایک ایماندار "خطرات اور انتباہات" سیکشن لکھیں: سمارٹ کنٹریکٹ کا خطرہ، مارکیٹ کا خطرہ، لیکویڈیٹی رسک، ریگولیٹری غیر یقینی صورتحال، کلیدی نقصان۔ ہر خطرے کی سادہ زبان میں وضاحت کریں۔ خطرات کو کم نہ سمجھیں؛ "یہ مالی مشورہ نہیں ہے" کے ساتھ ختم کریں۔

4) دستاویزی کوڈ کی مستقل مزاجی کی جانچ:

ذیل میں ایک فنکشن اور اس کی دستیاب دستاویزات ہیں۔ ان جگہوں کو نشان زد کریں جہاں دستاویز کوڈ کے اصل رویے سے متصادم یا متصادم ہو۔ حتمی فیصلہ کرنا؛ اسے "ڈویلپر کی تصدیق" کے لیے جمع کروائیں۔

تین چھوٹے کیسز (تعداد میں)

کیس 1 — NatSpec نے معائنہ کو تیز کر دیا۔ ایک ٹیم نے بغیر کسی تبصرہ کے جائزہ کے لیے 25 فنکشن کا معاہدہ جمع کرایا۔ آڈیٹر نے منطق کو سمجھنے کے لیے اضافی وقت مانگا۔ ٹیم نے AI کے ساتھ NatSpec ڈرافٹ تیار کیے اور کوڈ کے ساتھ ہر ایک کی تصدیق کی۔ آڈٹ کی تیاری تقریباً 1 دن مختصر کر دی گئی۔ سبق: اچھی دستاویزات آڈٹ کی لاگت کو کم کرتی ہیں۔

کیس 2 - جھوٹا دعوی پکڑا گیا۔ YZ تیار کردہ صارف دستی میں کہا گیا ہے کہ "آپ کے فنڈز کسی بھی وقت نکالے جا سکتے ہیں"؛ جبکہ معاہدہ میں 7 دن کا لاک تھا۔ تکنیکی جائزہ نے اسے پکڑ لیا۔ اگر اسے شائع کیا گیا تو، صارفین کو غلطی اور شکار کیا جائے گا. سبق: ہر تکنیکی دعوے کی تصدیق کوڈ سے ہوتی ہے۔

کیس 3 - مبالغہ آرائی ختم ہوگئی۔ پہلے وائٹ پیپر ڈرافٹ میں، AI نے "خطرے کے بغیر اعلی واپسی" جیسے تاثرات کا استعمال کیا۔ ٹیم نے ان کو ہٹا دیا اور ایک ایماندار رسک سیکشن شامل کیا۔ اس نے اس منصوبے کو اخلاقی اور قانونی طور پر تحفظ فراہم کیا۔ سبق: AI کی مارکیٹنگ کے تعصب کا آڈٹ ہونا ضروری ہے۔

دستاویزات کا اخلاقی بوجھ

Web3 دستاویزات کو اس تناظر میں پڑھا جاتا ہے جہاں صارف اپنے پیسے کو خطرے میں ڈال رہا ہے۔ لہذا:

  • ایمانداری: خطرات کو چھپایا نہیں جا سکتا اور مبالغہ آمیز وعدے نہیں کیے جا سکتے۔
  • درستگی: تکنیکی دعوے کوڈ سے مماثل ہونا چاہیے۔ "دستاویز میں ایسا کہا گیا ہے" دفاع نہیں ہے، بلکہ غلط بیانی ہے۔
  • رسائی: اس زبان میں لکھنا جسے صارف حقیقت میں سمجھتا ہے ایک حفاظتی اقدام ہے۔ جو دستاویز سمجھ میں نہیں آتی وہ فریب کو دعوت دیتی ہے۔
  • ڈس کلیمر: یہ واضح طور پر بیان کیا جانا چاہئے کہ یہ مالی مشورہ اور ریگولیٹری غیر یقینی صورتحال نہیں ہے۔
ٹپ: ویب 3 دستاویز کی ایمانداری کا امتحان: "اگر کوئی صارف صرف اس دستاویز پر بھروسہ کرکے پیسہ لگاتا ہے، تو کیا سچائی کا سامنا کرنے پر وہ خود کو دھوکہ محسوس کرے گا؟" AI کو ہمیشہ خطرے والے حصے کو نمایاں کریں، اسے آخر میں دفن نہ کریں۔

عام غلطیاں

  • کوڈ کے ساتھ تکنیکی دعوے کی تصدیق نہیں کرنا۔ غلط دستاویز صارف کو گمراہ کرتی ہے۔
  • ہائپ/مارکیٹنگ کی زبان کو چھوڑنا۔ اخلاقی اور قانونی خطرہ۔
  • خطرات کو کم کرنا یا چھپانا۔ اعتماد کی خلاف ورزی۔
  • AI کو اصلی میکانزم دیے بغیر وائٹ پیپر پرنٹ کرنا۔ اس سے من گھڑت چیزیں پیدا ہوتی ہیں۔
  • "مالی مشورہ نہیں" انتباہ کو نظر انداز کرنا۔ قانونی ذمہ داری۔
  • دستاویزات کو کوڈ کے ساتھ مطابقت پذیر نہ رکھنا۔ جب کوڈ تبدیل ہوتا ہے تو دستاویز گمراہ کن ہو جاتی ہے۔

خلاصہ میں

  • دستاویزات ویب 3 میں سیکیورٹی اور اعتماد کا معاملہ ہے۔ یہ AI کا سب سے زیادہ پیداواری فیلڈ ہے۔
  • غلطی کی قیمت نسبتاً کم ہے، لیکن جھوٹے تکنیکی دعوے اور مبالغہ آرائی سنگین خطرات ہیں۔
  • ہر تکنیکی دعوے کی تصدیق حقیقی کوڈ سے ہونی چاہیے۔ دستاویز کوڈ کو تبدیل نہیں کرتا ہے۔
  • خطرات کو ایمانداری اور نمایاں طور پر لکھا جانا چاہئے؛ مبالغہ آرائی اور گارنٹی کی زبان کو ختم کیا جائے۔
  • "یہ مالی مشورہ نہیں ہے" اور ریگولیٹری انتباہات لازمی ہیں۔

درخواست کا کام

ایک سمارٹ کنٹریکٹ فنکشن حاصل کریں۔ AI کو "Generate NatSpec" پرامپٹ دیں اور تیار کردہ تشریحی لائن کا کوڈ کے اصل رویے سے لائن کے لحاظ سے موازنہ کریں — کیا کوئی اختلاف ہے؟ پھر اسی فنکشن کے لیے ایک "تکنیکی-سادہ ترجمہ" اور "خطرہ/انتباہی سیکشن" تیار کریں۔ AI کا کم از کم ایک بیان تلاش کریں اور درست کریں جو مبالغہ آمیز ہے یا کوڈ سے متصادم ہے۔

چیک لسٹ

  • میں نے اصل کوڈ کے ساتھ ہر تکنیکی دعوے کی تصدیق کی۔
  • میں نے مبالغہ آرائی/ ضمانتیں ہٹا دیں۔
  • میں نے خطرات کو ایمانداری سے لکھا اور ان کو اجاگر کیا۔
  • میں نے AI کو حقیقی طریقہ کار دیا؛ میں نے اسے بنانے نہیں دیا۔
  • میں نے انتباہ شامل کیا "یہ مالی مشورہ نہیں ہے۔"
  • میں نے گاڑی اور کنٹرول کے لیے مکمل طور پر NatSpec لکھا۔
  • میں نے دستاویزات کو کوڈ کے ساتھ مطابقت پذیر رکھنے کا منصوبہ بنایا۔