استاندارد UX Writing در تریپیلون
۱. هدف
این راهنما روش تولید و کنترل متن داخل محصول را تعریف میکند. متن واقعی هر صفحه باید در فایل UX Writing داخل پوشه همان ماژول ثبت شود؛ این سند جای خروجی ماژول را نمیگیرد.
۲. ورودیهای لازم
- مسئله و هدف صفحه
- Actor و سطح آشنایی او
- User Flow و نقطه ورود
- Action اصلی و نتیجه واقعی آن
- محدودیتها و Validation
- وضعیتهای سیستم و امکان Recovery
- اثر مالی، حقوقی، دسترسی یا تغییر رابطه
- واژگان Domain و تصمیمهای برند
۳. شخصیت و لحن
صدای تریپیلون مطمئن، مستقیم، همراه و بیطرف است.
| ویژگی | رفتار نوشتاری |
|---|---|
| روشن | نتیجه و Action با واژههای آشنا بیان میشود. |
| مسئول | اثر مالی، دسترسی و تغییر رابطه پنهان نمیشود. |
| همراه | کنار خطا، راه حل یا گام بعدی نمایش داده میشود. |
| بیطرف | متن عملیاتی قضاوتی یا تبلیغاتی نیست. |
لحن با موقعیت تغییر میکند:
- ورود و راهاندازی: کوتاه و راهنما
- پرداخت: دقیق و اطمینانبخش
- خطا: آرام، مشخص و قابلاقدام
- اقدام حساس: صریح و بدون ابهام
- موفقیت: تأییدکننده و کوتاه
۴. قواعد عمومی
- عنوان صفحه نتیجه یا کار اصلی را بیان میکند.
- هر دکمه با فعل روشن آغاز میشود.
- CTA اصلی فقط یک Action را وعده میدهد.
- Label پایدار است و Placeholder جای آن را نمیگیرد.
- متن کمکی فقط محدودیت یا دلیل ضروری را توضیح میدهد.
- پیام خطا اتفاق، وضعیت و گام بعدی را روشن میکند.
- پیام موفقیت نتیجه واقعی سیستم را تأیید میکند.
- متن مالی همیشه مبلغ، واحد پول و اثر اقدام را نشان میدهد.
- اقدام برگشتناپذیر موضوع و پیامد را در Confirmation تکرار میکند.
- واژگان یک مفهوم در همه صفحات یکسان میمانند.
۵. الگوهای محتوا
CTA
| هدف | الگو |
|---|---|
| ادامه جریان | ادامه |
| ثبت داده | ثبت + موضوع |
| ارسال | ارسال + موضوع |
| تکرار ارسال | ارسال دوباره + موضوع |
| پرداخت | پرداخت + مبلغ |
| اقدام حساس | فعل دقیق + موضوع |
CTAهایی مانند «تأیید»، «باشه»، «بزن بریم» و «مرحله بعد» بدون Context کافی نیستند.
Validation
الگو:
مشکل مشخص + راه اصلاح
نمونه:
«شماره موبایل باید ۱۱ رقم باشد.»
خطای سیستمی
الگو:
نتیجه ناموفق + وضعیت داده یا پرداخت + گام بعدی
نمونه:
«ساختمان ایجاد نشد. مبلغی از حساب شما کم نشده است. چند دقیقه دیگر دوباره تلاش کنید.»
تأیید اقدام حساس
- عنوان همنام Action
- توضیح پیامد برای Resource مشخص
- CTA اصلی همنام Action
- CTA فرعی «انصراف»
۶. موجودی محتوای صفحه
برای هر صفحه، اقلام مرتبط از این فهرست ثبت میشوند:
- عنوان و توضیح صفحه
- Label و Placeholder
- متن کمکی
- CTA اصلی و فرعی
- Validationهای فیلد
- Loading و Progress
- Empty State
- Error و Recovery
- Success
- Confirmation
- Notification یا Snackbar
- Accessibility Label
۷. قالب خروجی
## WF-XX — نام صفحه
| کلید | متن نهایی | Context/شرط نمایش | وضعیت |
| --- | --- | --- | --- |
| `screen.title` | ... | H1 صفحه | Draft |
| `screen.description` | ... | توضیح کوتاه | Draft |
| `field.label` | ... | Label پایدار | Draft |
| `field.placeholder` | ... | مثال قالب | Draft |
| `action.primary` | ... | CTA اصلی | Draft |
| `validation.required` | ... | فیلد خالی | Draft |
| `validation.invalid` | ... | قالب نامعتبر | Draft |
| `state.loading` | ... | پردازش | Draft |
| `state.error` | ... | خطای سیستمی | Draft |
| `state.success` | ... | نتیجه موفق | Draft |
وضعیت هر رشته یکی از این مقادیر است:
DraftIn ReviewApprovedDeprecated
۸. اعداد و قالبها
- رقم فارسی در متن عمومی و رقم انگلیسی در شناسه، API و کد استفاده میشود.
- شماره موبایل با یک قالب ثابت محصول نمایش داده میشود.
- مبلغ جداکننده هزارگان و واحد پول دارد.
- شمارش معکوس زمان باقیمانده را روشن نمایش میدهد.
- تاریخ رابط بر اساس تقویم مصوب محصول و تاریخ فنی با ISO ثبت میشود.
۹. دسترسپذیری محتوا
- وضعیت فقط با رنگ منتقل نمیشود.
- Error به فیلد و Summary قابل دسترسی متصل است.
- آیکن مستقل Accessibility Label دارد.
- CTA در Loading همچنان هدف Action را منتقل میکند.
- اعلان زمان یا Progress برای Screen Reader آزاردهنده و پیوسته نیست.
- ترتیب خواندن متن فارسی، عدد و عبارت انگلیسی کنترل میشود.
۱۰. کنترل کیفیت
- متنهای واقعی فقط در خروجی ماژول ثبت شدهاند.
- تمام رشتهها Context و وضعیت دارند.
- CTA نتیجه Action را درست وعده میدهد.
- خطا راه بازیابی دارد.
- واژگان با Domain و صفحات قبلی یکساناند.
- متن Figma و سند خروجی همگاماند.