---
title: "تعارف"
description: "سات عملی دستاویزاتی ماڈل کیوں موجود ہے۔"
doc_version: "2025-01-09"
last_updated: "2026-08-09"
canonical_url: "https://7act.org/ur/rationale/"
language: "ur"
license: "CC BY 4.0"
---

# تعارف

میرا خیال ہے کہ ہر فنی مصنف کبھی نہ کبھی اپنے کام کو «لوگ ہمیشہ سے ایسے ہی دستاویزات بناتے آئے ہیں» سے زیادہ منظم کسی بنیاد پر رکھنا چاہتا ہے۔ ٹول کٹ اور فریم ورک مواد کی اقسام دیتے ہیں، جو اس وقت بہت قیمتی ہیں جب آپ *جانتے* ہوں کہ کیا لکھنا ہے؛ مگر وہیں سے *شروع کرنا* ایسا ہے جیسے ہتھوڑا خریدنا اور یہ نہ جاننا کہ آدھا کام پیچ گھمانا ہو گا۔

## دستاویزی فریم ورک، آلات اور فارمیٹ کافی نہیں

زیادہ تر موجودہ دستاویزی فریم ورک فنی مصنفین کے اعمال پر توجہ دیتے ہیں، نہ کہ صارفین، یعنی دستاویزات *استعمال کرنے والوں*، کے اعمال پر۔ اس بات پر تجویزی زور کہ کون سی دستاویزات بننی چاہییں، ان صارف ضرورتوں کو بیان کرنے کی جگہ جنہیں پورا ہونا چاہیے، اس معماری ذہنیت کی بازگشت ہے جو دیواریں اس لیے بناتی ہے کہ *گھر میں کمرے تو ہونے ہی چاہییں، کیا ہم وحشی ہیں*؟ لچک کی یہ ظاہری کمی وہ مواد لکھنے کی حوصلہ شکنی کرتی ہے جس کی واقعی ضرورت ہے۔

ان فریم ورکوں کے بعض ڈیزائنر مسئلے سے واقف ہیں اور کہتے ہیں کہ اصول لفظ بہ لفظ نہ اپنائے جائیں اور حقیقی دنیا میں اطلاق کے لیے لچک ہو۔ فریم ورک استعمال کرنے والے لکھنے والوں نے بھی اس مخمصے کا سامنا کیا اور اکثر اپنے مقصد کے لیے ماڈلوں کو بدل لیا۔ یوں فریم ورک اوزاروں کا ڈبہ بن جاتے ہیں جس سے سانچے اور خیال چن لیے جاتے ہیں۔ لیکن یہ انداز اس سوال سے بچتا ہے کہ اصل میں کیا درکار ہے۔

تیزی سے بدلتی مصنوعات کو کم وسائل اور مدد کے ساتھ دستاویز کرنے کی پیچیدگی میں، مصنف جو کچھ ملے اسے لے کر قابل عمل طریقہ بنا لیتے ہیں۔ دوسری طرف دستاویزات میں قدم رکھنے والے اور اس میدان میں گم محسوس کرنے والے انجینئر فریم ورکوں کی طرف متوجہ ہوتے ہیں کیونکہ پروگرامنگ میں انہیں فریم ورکوں کے ساتھ ہی کام کرنے کی عادت ہوتی ہے۔ آخر میں جو دستاویزات بنتی ہیں وہ مؤثر دستاویزات کا کارگو کلٹ نسخہ ہوتی ہیں۔

## مواد کی اقسام سے صارف ضرورتوں کی طرف توجہ منتقل کرنا

ایک حل یہ ہے کہ توجہ کو اس سے ہٹایا جائے کہ کیا لکھنا چاہیے اور اس طرف لایا جائے کہ صارف کی کون سی ضرورت پوری ہونی چاہیے۔ اس کے لیے پہلے سے بنے ساختی نمونوں کے مطابق مواد پیدا کرنے کے بجائے دستاویزات کے حکمت عملی والے پہلو، یعنی مواد کی حکمت عملی، کی ذمہ داری لینا ضروری ہے۔ یہ طریقہ Diátaxis، DITA اور دوسرے فریم ورکوں کے ساتھ مکمل طور پر موافق ہے، کیونکہ یہ دستاویز بنانے والوں کو سمت اور مقصد دیتا ہے؛ پھر وہ دستیاب مواد کی اقسام، عناصر اور آلات استعمال کرتے ہیں۔

سینڈوچ کا استعارہ بہتر بتاتا ہے کہ میرے خیال میں فریم ورک، آلات اور صارف ضرورت کے ماڈل کیسے ملتے ہیں—خصوصاً اگر آپ نے ابھی دوپہر کا کھانا نہ کھایا ہو۔ فریم ورک اور آلات سینڈوچ کو اکٹھا اور قابلِ استعمال رکھنے والے لازمی اجزا ہیں، مگر سینڈوچ کو ذائقہ اور معنی دینے والی چیز بھراؤ ہے، یعنی صارف ضرورتوں کا وہ ذہنی ماڈل جس کی آپ پیروی کرتے ہیں۔ یہ بیرونی متعلقہ فریقوں کی درخواستوں جیسا *نہیں* ہے، اگرچہ باہم مل سکتا ہے۔ اور اگر کوئی چیز ہے تو OKR چٹنی ہیں۔

![دستاویزاتی سینڈوچ: اوپر فریم ورک اور مواد کی اقسام، درمیان میں صارف ضرورتیں، اور نیچے فارمیٹ اور آلاتی زنجیریں۔](https://passo.uno/uploads/sandwich-2.jpg)

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

آگے صارف ضرورتوں کا میرا *وضاحتی* ماڈل ہے، جس پر میں آج دستاویزات بنانے اور ترتیب دینے میں عمل کرتا ہوں۔

## سات عملی دستاویزاتی ماڈل

میرا یہاں پیش کردہ طریقہ *ان صارف اعمال کا ماڈل ہے جو دستاویزات کو پورا کرنا چاہیے*۔ یہ UX تحقیق اور دستاویزی فریم ورکوں کو ایک تصوری اور عملی سطح سے جوڑتا ہے جو دو چیزوں پر توجہ دیتی ہے: بطور مصنوعات دستاویزات، اور وہ جو صارف اس کے ذریعے حاصل کرتے ہیں۔ یہ اس بات کو بیان کرنے کی کوشش ہے کہ فنی دستاویزات کو *کیا کرنا چاہیے*؛ یعنی دستاویزات کو ایسی مصنوعات سمجھنا جسے کوئی حقیقی مقصد حاصل کرنے کے لیے استعمال کرتا ہے۔

جیسا کہ میں نے کہا، ماڈل کا مرکز *اعمال* ہیں۔ میں نے سات اعمال شناخت کیے ہیں جو ان اہداف کا اچھا حصہ پورا کرتے ہیں جو دستاویزات کا صارف استعمال کے وقت حاصل کرنا چاہتا ہے۔ یہ مختلف مصنوعات اور میدانوں میں دستاویزات کے ساتھ صارف تعامل کے عام نمونے ہیں: جانچ (تمیز)، فہم (سیکھ)، کھوج (دریافت)، مشق (تربیت)، یاد (بازیافت)، ڈیویلپمنٹ (انضمام) اور خرابی دور کرنا (حل)۔

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

## نتیجہ

یہاں پیش کردہ ماڈل مواد کی اقسام کے بجائے صارف ضرورتوں کے عدسے سے دستاویزات کے بارے میں سوچنے کا طریقہ دیتا ہے۔ اس کا مقصد موجودہ فریم ورکوں کو بدلنا نہیں بلکہ ان کی تکمیل کرنا ہے۔ ساتھ استعمال ہونے پر یہ فنی مصنفین کو ایسا مواد بنانے دیتے ہیں جو ساختی طور پر مضبوط اور حقیقی طور پر مفید ہو، نہ کہ محض سانچے بھرے۔

یہ ماڈل [دستاویزی پیمانوں اور مقصد مقرر کرنے](https://passo.uno/docs-observability-do11y/) (do11y) کی بنیاد بھی بن سکتا ہے۔ صرف صفحہ دیکھنے یا اطمینان کے نمبر پر توجہ دینے کی بجائے ٹیمیں ناپ سکتی ہیں کہ ان کی دستاویزات ہر عمل کی کس حد تک خدمت کرتی ہیں۔ مثال کے طور پر دستاویزات سے مصنوعات اپنانے تک تبدیلی کی شرح جانچ کی افادیت ناپ سکتی ہے، جبکہ حل کا وقت خرابی دور کرنے کی کامیابی کی طرف اشارہ کر سکتا ہے۔

نظری ماڈلوں کی طرح یہ ماڈل وسیع تحقیق یا عاملی تجزیے سے تقویت نہیں پاتا۔ اسے جیسا ہے ویسا تقسیم کیا جاتا ہے اور آپ کسی حال میں مجھے آپ کا کھانا خراب کرنے کا ذمہ دار نہیں ٹھہرا سکتے۔ پھر بھی امید ہے کہ یہ زیادہ مقصدی فنی دستاویزات کے متلاشی لوگوں کے لیے مفید نقطۂ نظر دے گا۔

![انڈیانا جونز اور دستاویزات کے سات اعمال کے ساتھ پکسل آرٹ کتب خانے کا منظر۔](https://passo.uno/uploads/indy.jpg)

## Sitemap

- [سات عملی دستاویزاتی ماڈل](https://7act.org/ur/index.md)
- [تعارف](https://7act.org/ur/rationale/index.md)
- [اعمال](https://7act.org/ur/actions/index.md)
- [جانچ](https://7act.org/ur/actions/appraise/index.md)
- [فہم](https://7act.org/ur/actions/understand/index.md)
- [کھوج](https://7act.org/ur/actions/explore/index.md)
- [مشق](https://7act.org/ur/actions/practice/index.md)
- [یاد](https://7act.org/ur/actions/remember/index.md)
- [ڈیویلپمنٹ](https://7act.org/ur/actions/develop/index.md)
- [خرابی دور کرنا](https://7act.org/ur/actions/troubleshoot/index.md)
- [لغتِ اصطلاحات](https://7act.org/ur/glossary/index.md)
- [سات عملی دستاویزاتی Skill](https://7act.org/ur/skill/index.md)