از تصمیم خواننده آغاز کنید
متن امنیتی اغلب برای ایجاد حس اطمینان نوشته میشود. مستند مفید از جای دیگری شروع میکند: خواننده چه تصمیمی دارد و کدام شاهد میتواند آن تصمیم را تغییر دهد؟
توسعهدهنده پیامرسان، بیمارستان ارزیاب گردش کار و بازدیدکننده فرم تماس با ریسکهای متفاوت روبهرو هستند. واژه کلی «امن» این مرزها را توضیح نمیدهد.
چهار وضعیت شواهد
ادعا را به چهار وضعیت تقسیم میکنیم: قابل مشاهده روی استقرار، پیادهسازیشده با شاهد نامبرده، جهت طراحی هنوز غیرفعال، یا نیازمند بررسی مستقل.
این تمایز وقتی مهم است که یک عبارت فنی در یک زمینه درست و در زمینه دیگر گمراهکننده باشد. لیوارا چت رمزنگاری سمت کاربر را برای محتوای مستقیم جدید مستند میکند، اما گروه و کانال مدل قابل خواندن برای سرور دارند.
- قابل مشاهده از سطح فعال
- پیادهسازیشده با شاهد داخلی مشخص
- برنامه یا در حال توسعه
- نیازمند بررسی مستقل
محدودیت باید کنار ادعا باشد
محدودیتی که در انتهای متن حقوقی پنهان شود، تیتر اصلی را روشن نمیکند. استثنا باید کنار قابلیت و با زبان قابل اقدام نوشته شود.
در سامانه سلامت باید روشن باشد میزبان عمومی چه زمانی نباید اطلاعات بیمار بگیرد و یک جزء گردش کار چه زمانی ابزار پزشکی یا جایگزین قضاوت بالینی نیست.
اعتماد وقتی رشد میکند که کوتاهترین نسخه ادعا هم درست بماند.
