چینج لاگ صفحہ کیسے بنائیں: اندراجات، ٹیگز، RSS اور 'نیا کیا ہے'

چینج لاگ صفحہ تاریخ کے مطابق ایک فہرست ہے کہ آپ کی پروڈکٹ میں کیا بدلا، سب سے نیا پہلے، ان لوگوں کے لیے لکھی ہوئی جو اسے استعمال کرتے ہیں۔ اسے بنانے کے لیے آپ کو ایسے اندراجات چاہئیں جن میں تاریخ، واضح عنوان، مختصر وضاحت اور ایک ٹیگ (New، Improved، Fixed) ہو، ایک صفحہ جو انہیں فہرست کرے، ہر اندراج کا الگ URL، اور مثالی طور پر ایک RSS feed اور یہ بتانے کا طریقہ کہ کوئی چیز نئی ہے۔ یہ سب سے سادہ چیزوں میں سے ایک ہے، اور اہم فیصلہ یہ ہے کہ اندراجات کہاں رہیں: آپ کی سائٹ میں فائلوں کے طور پر، یا admin صفحے کے ساتھ ڈیٹابیس میں۔

چینج لاگ کیوں مفید ہے

چینج لاگ گاہکوں اور ممکنہ خریداروں کو دکھاتا ہے کہ پروڈکٹ زیرِ دیکھ بھال ہے۔ یہ سپورٹ اور سیلز کو ایک لنک دیتا ہے جو وہ اس وقت بھیج سکتے ہیں جب کوئی پوچھے "کیا یہ X کرتا ہے؟"۔ یہ فیڈبیک کا حلقہ بند کرنے کی جگہ بھی ہے: جب کوئی مانگا ہوا فیچر آ جائے، تو چینج لاگ کا اندراج وہی ہے جس کی طرف آپ لوگوں کو اشارہ کرتے ہیں۔ اگر آپ کسٹمر فیڈبیک پورٹل چلاتے ہیں، تو شپ شدہ درخواستوں کو سیدھا ان کے اندراجات سے جوڑیں۔

چینج لاگ آپ کی اندرونی commit تاریخ نہیں ہے۔ "billing سروس کی ری فیکٹرنگ" صارف کے لیے بے معنی ہے۔ "اب انوائسز پر آپ کی کمپنی کا VAT نمبر ظاہر ہوتا ہے" معنی رکھتا ہے۔

صفحے کو کیا چاہیے

ہر اندراج کا مواد

صفحات

• چینج لاگ انڈیکس: سب سے نیا پہلے، ٹیگ فلٹرز اور سادہ pagination یا "مزید دیکھیں" کے ساتھ۔
• اندراج کا صفحہ: ہر اندراج کا ایک URL، تاکہ اسے لنک اور شیئر کیا جا سکے۔
• RSS یا Atom feed: لوگوں اور ٹولز کو ای میل کے بغیر اپ ڈیٹس فالو کرنے دیتا ہے۔
• Admin صفحہ (صرف ڈیٹابیس والے ورژن میں): اندراجات لکھیں، پیش نظارہ دیکھیں، شیڈول کریں اور شائع کریں۔

ایپ کے اندر کی اضافی چیزیں

• "نیا کیا ہے" بیج: کسی مینو آئٹم پر ایک نقطہ جب ایسے اندراجات ہوں جو صارف نے نہیں دیکھے۔ آخری کھولے گئے اندراج کی تاریخ فی صارف یا براؤزر میں محفوظ کریں۔
• ای میل ڈائجسٹ: ان صارفین کو خلاصہ جو opt in کریں۔ اس کے لیے ای میل بھیجنے والا provider درکار ہے؛ دیکھیں ایپ سے ای میلز بھیجنا۔

بڑا فیصلہ: فائلیں یا ڈیٹابیس

سائٹ میں فائلوں کے طور پر اندراجات

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

یہ ان ٹیموں کے لیے موزوں ہے جہاں اندراجات لکھنے والے AI builder سے پوچھنے یا فائل میں ترمیم کرنے میں آرام محسوس کرتے ہیں۔

ڈیٹابیس میں اندراجات، admin صفحے کے ساتھ

اندراجات ایک ٹیبل میں رہتے ہیں، اور ایک نجی admin صفحہ ٹیم کے کسی بھی فرد کو لکھنے، پیش نظارہ دیکھنے، شیڈول کرنے اور شائع کرنے دیتا ہے۔ یہ ان ٹیموں کے لیے موزوں ہے جہاں مارکیٹنگ یا سپورٹ اپ ڈیٹس لکھتی ہے، یا جب آپ کو شیڈول شدہ اشاعت یا ہر سامعین کے لیے الگ اندراجات چاہئیں (مثلاً صرف انٹرپرائز گاہکوں کو انٹرپرائز فیچرز دکھانا)۔

اس کی قیمت یہ ہے کہ بنانے اور سنبھالنے میں زیادہ کام ہے: admin لاگ ان، تصاویر اپلوڈ، اور یہ یقینی بنانا کہ عوامی صفحات اب بھی سرچ انجنوں کے لیے پڑھنے کے قابل ہوں، جو ایک صفحہ شاید نہ ہو جو اندراجات صرف براؤزر میں لوڈ کرتا ہو۔

ایسے اندراجات لکھنا جو لوگ پڑھیں

• فائدے سے شروع کریں۔ "رپورٹس Excel میں ایکسپورٹ کریں" بمقابلہ "نیا export ماڈیول" سے بہتر ہے۔
• بتائیں کہ یہ کسے ملتا ہے۔ تمام پلانز، صرف Pro، اس ہفتے آ رہا ہے۔
• دکھائیں۔ ایک اسکرین شاٹ یا مختصر کلپ۔
• چھوٹی درستیاں اکٹھی کریں۔ ایک ہفتہ وار "Fixes and improvements" اندراج بلٹس کے ساتھ صفحے کو بھرنے سے بچاتا ہے۔
• ہٹائی گئی چیزوں کے بارے میں سچ بولیں۔ اگر کوئی چیز ختم ہو رہی ہے تو بتائیں کب اور اس کی جگہ کیا استعمال کریں۔

نمونہ پہلا prompt

ہماری سائٹ پر /changelog پر ایک عوامی چینج لاگ شامل کرو۔ ہر اندراج ایک Markdown فائل ہو جس میں عنوان، تاریخ، ٹیگ (New، Improved یا Fixed)، اختیاری کور تصویر اور متن ہو۔ انڈیکس صفحہ سب سے نئے اندراجات پہلے دکھائے، تاریخ، ٹیگ اور پہلے پیراگراف کے ساتھ، ٹیگ فلٹر بٹن رکھے، اور فی صفحہ 10 اندراجات دکھائے۔ ہر اندراج کا اپنا صفحہ /changelog/<slug> پر ہو، سرچ انجنوں کے لیے مناسب صفحہ عنوان اور تفصیل کے ساتھ۔ /changelog/rss.xml پر ایک RSS feed شامل کرو۔ تین نمونہ اندراجات بناؤ۔ موجودہ سائٹ کے ڈیزائن سے میل کھاتا ہوا، فون پر پڑھنے میں آسان، اور صفحات پری رینڈر کرو تاکہ وہ تیزی سے لوڈ ہوں۔

ڈیٹابیس والے ورژن کے لیے پہلے جملے کی جگہ لکھیں: "اندراجات کو draft/published حیثیت اور اشاعت کی تاریخ کے ساتھ ڈیٹابیس میں محفوظ کرو، اور ایک پاس ورڈ سے محفوظ admin صفحہ شامل کرو جہاں انہیں لکھا، پیش نظارہ دیکھا اور شائع کیا جا سکے۔"

بلڈ کے مراحل

1. فائلیں یا ڈیٹابیس چنیں، اوپر کی جدول کے مطابق۔
2. انڈیکس اور اندراج کے صفحات بنائیں، چند نمونہ اندراجات کے ساتھ۔
3. ٹیگز اور فلٹرز شامل کریں۔
4. RSS feed شامل کریں اور صفحے سے اس کا لنک دیں۔
5. ہر اندراج کے لیے صفحہ عنوان، تفصیل اور sitemap میں اندراج شامل کریں۔ AI سے بنی ویب سائٹس کے لیے SEO بنیادی باتیں بتاتی ہے۔
6. Admin صفحہ اور لاگ ان، اگر آپ نے ڈیٹابیس کا راستہ چنا ہے۔
7. "نیا کیا ہے" بیج اپنی ایپ میں۔
8. پچھلے کچھ مہینوں کے حقیقی اندراجات لکھیں تاکہ صفحہ خالی لانچ نہ ہو۔

عام غلطیاں

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

کب ہوسٹڈ چینج لاگ ٹول بہتر انتخاب ہے

ہوسٹڈ چینج لاگ اور پروڈکٹ اپ ڈیٹ ٹولز موجود ہیں، اور کچھ فیڈبیک بورڈز یا ایپ کے اندر وِجٹس کے ساتھ آتے ہیں۔ یہ اس وقت قابلِ قدر ہیں جب آپ کو ایپ کے اندر پاپ اپ، سامعین کا ہدف اور تجزیات بغیر بنائے چاہئیں، یا جب آپ کی ٹیم پہلے سے ایسا ٹول خریدتی ہے جس میں یہ شامل ہو۔ آپ کے بلاگ یا مدد مرکز کے سافٹ ویئر میں بھی پہلے سے مناسب فارمیٹ ہو سکتا ہے۔

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

Mythex کے ساتھ بنانا

Mythex پر آپ ایجنٹ سے موجودہ پروجیکٹ میں چینج لاگ شامل کرنے کو کہہ سکتے ہیں، یا اسے ایک الگ چھوٹی سائٹ کے طور پر بنوا سکتے ہیں، اور بنتے ہوئے live preview میں دیکھ سکتے ہیں۔ فائل پر مبنی ورژن کو ڈیٹابیس کی ضرورت نہیں۔ اگر آپ admin والا ورژن چنتے ہیں، تو اندراجات محفوظ کرنے کی ضرورت پڑنے پر ایجنٹ ایک مخصوص Postgres ڈیٹابیس شامل کرتا ہے (یا /database لکھیں)، اور اسکرین شاٹس پروجیکٹ کی file storage میں جاتے ہیں۔ admin سائن ان وہ چیز ہے جو آپ اپنے auth طریقے سے شامل کرتے ہیں (add login recipe)۔

نئی Mythex ایپس اکثر کلائنٹ پر رینڈر ہونے والی single-page ایپس ہوتی ہیں، جن کے بارے میں SEO recipe بتاتی ہے کہ وہ سرچ کے لیے کمزور ہیں، اس لیے اگر آپ چاہتے ہیں کہ اندراج سرچ میں ملیں تو static یا پری رینڈرڈ چینج لاگ صفحات مانگیں۔ یہی recipe صفحہ عنوانات، تفصیلات اور sitemaps بھی بیان کرتی ہے۔ built-in چینج لاگ کے ساتھ ابتدائی نقطے کے لیے product knowledge hub ٹیمپلیٹ دیکھیں۔

سوالات