مرتب کردن مستندات پروژه با هوش مصنوعی
دو راهنمای پروژه درباره یک کار حرف متفاوتی میزنن؟ متنها و دستورهاشون رو مقایسه کنید، اطلاعاتی رو که هنوز لازمه نگه دارید و ارجاعهای قدیمی رو به جای درست برسونید.
مرتب کردن مستندات پروژه با هوش مصنوعی وقتی ارزش داره که کسی قراره از روی اون نوشته کاری انجام بده. فرض کنید همکار جدیدتون دو راهنما پیدا کرده که برای اجرای پروژه دو دستور متفاوت دارن. ممکنه یکی برای نسخه قدیمی باشه، یا هر دو درست باشن ولی برای دو محیط جدا نوشته شده باشن. اسکیل docs-cleaner محل استفاده هر دستور و منبعی رو که روش فعلی پروژه رو نشون میده بررسی میکنه تا معنی اختلاف معلوم بشه.
برای جمع کردن پوشه مستندات هم میتونید دو فایل قدیمی رو مقایسه کنید. شاید مقدمهها تقریبا یکی باشن، اما در انتهای یکی از فایلها توضیح داده شده چرا ترتیب دو مرحله عوض شده. بعد از جابهجایی هم میتونید بررسی کنید خوانندهای که از فهرست یا یک راهنمای دیگه وارد میشه، هنوز به همون توضیح میرسه.
کاربردها
- برای ادغام مستندات، سطرهایی رو پیدا کنید که یک دستور رو در چند جا تکرار کردن یا شرط اجرای اون رو جا انداختن.
- راهنمای نصب رو با روش فعلی اجرای پروژه مقایسه کنید تا مشخص بشه دستور کجا تغییر کرده و کجا فقط اسمش عوض شده.
- اطلاعات تکراری رو از توضیحی جدا کنید که فقط در یک فایل نوشته شده و دلیل یک تصمیم قدیمی رو نگه داشته.
- بعد از تغییر اسم یک بخش، هر لینک شکسته به عنوان قبلی رو پیدا کنید و مسیر رسیدن به توضیح رو دوباره بررسی کنید.
- پیش از کنار گذاشتن یک سند، برای بخشهایی که هنوز استفاده میشن مقصد مشخص کنید تا چیزی بین دو نسخه گم نشه.
نصب و استفاده
- اسکیل رو در ایجنتی نصب کنید که به فایلهای پروژه دسترسی داره. برای بررسی محلی متن و لینکها میتونید از ابزارهای جستجوی پروژه استفاده کنید.
- بگید کدوم پوشه یا تغییر موضوع بررسیه و آیا فقط یک پیشنهاد میخواید یا ویرایش فایلها هم درخواسته.
- یک دستور، نکته تاریخی و لینک ورودی رو در نسخه نهایی دنبال کنید و ببینید خواننده هنوز به اطلاعات لازم میرسه.
سوالات متداول
منبع
ساخته daymade. نام اصلی: docs-cleaner، منتشرشده در GitHub با مجوز MIT.
مشاهده در GitHub