فريق التحرير

يكتب شخص واحد الأدلة. ويقرأ شخص آخر المحتوى المالي لكل دليل قبل نشره. توضح هذه الصفحة من هم، وما الذي تتحقق منه المراجعة، وما يمكنك التحقق منه بنفسك.

المؤلف

Kostan Proff

يعمل في البنية التحتية التقنية — السحابة، والتكامل المستمر والتسليم المستمر، والبنية التحتية كشيفرة — حيث لا يُنشر أي تغيير يتعذر التحقق منه. الحفاظ على بيئات السحابة خفيفة وسير عمل التسليم سريع هو عمله اليومي؛ وينطبق المعيار نفسه على هذا الموقع. تُحفظ الحسابات في مكان واحد، وتغطي المعادلات اختبارات وحدات تقارنها بأرقام قروض منشورة، ويحمل كل رقم قادم من مصدر خارجي مصدره وتاريخ قراءته. يكتب الأدلة ويشرف على محرك الحساب.

GitHub

المراجع المالي

Tetiana Goncharko

يقرأ المحتوى المالي لأي دليل قبل نشره: الأرقام، والافتراضات التي تقف خلفها، والمصادر التي تأتي منها. يبني المؤلف محرك الحساب؛ أما المراجع فيقرأ النتيجة من الجهة المقابلة، أي من منظور شخص يتعامل مع المال لا مع الشيفرة. لا يظهر اسمها إلا في الأدلة التي راجعتها.

LinkedIn

ما يمكنك التحقق منه

الحساب متاح للعامة

الشفرة المصدرية لكل حاسبة موجودة في مستودع عام، وتتضمن الصيغ التي ينفذها، واختبارات الوحدات التي تقارن نتائجها بأرقام منشورة معروفة، والفحوص التي تمنع إصدار نسخة عند وجود صفحة معطلة. لست مضطرًا إلى تصديق الأرقام، ولا إلى طلب تبريرها.

افتح المستودع

اسمان، وظيفتان

يكتب أحد الاسمين الأدلة ويصون محرك الحساب. ويقرأ الاسم الآخر المحتوى المالي للدليل قبل نشره، متحققًا من الأرقام والافتراضات التي تقف خلفها والمصادر التي جاءت منها. الفصل بين الوظفتين مقصود: فشخص الدليل ليس هو من يراجعه أخيرًا.

عندما يذكر دليل اسم مراجع، فهذا هو الشخص الذي راجعه، ويظهر الاسم في ذلك الدليل وحده. المراجعة بيان عن صفحة محددة، لذا تُربط بالصفحة لا بالموقع ككل.

تصف بقية هذه الصفحة ما تتحقق منه المراجعة، وما يستطيع القارئ التحقق منه دون سؤال أحد.

ما تتحقق منه المراجعة

قبل نشر أي دليل، يراجع المراجع القائمة نفسها في كل مرة:

  • الحساب. تتحقق كل معادلة من مصدرها، ويُعاد حساب المثال التوضيحي في النص من البداية. وعندما يظهر رقم في الشيفرة، يُقارن الرقمان.
  • الوحدات. النسب المئوية مقابل الأعداد العشرية، والأشهر مقابل السنوات، والدولارات مقابل الآلاف. معظم الأخطاء في المستند المالي هي أخطاء في الوحدات.
  • الحالات الحدّية. معدل صفري، أو مدة صفرية، أو قيمة سالبة. يُتحقق من كل حالة للتأكد من أنها تنتج إجابة منطقية لا رسالة خطأ.
  • الصياغة. يجب ألا تخبر الصفحة القارئ بما يفعله. فهي تشرح معنى الرقم وما يعتمد عليه، ثم تتوقف عند ذلك. ويُعاد صياغة أي دليل يوصي بإجراء ما.
  • المصادر. يُفتح كل رابط، ويُتحقق من الادعاء المرتبط به، ويُوضع عليه تاريخ.

كيف تُستخدم أدوات الصياغة

تساعد أدوات الصياغة على تحسين النص. لكنها لا تقرر ما تقوله الصفحة. كل رقم وكل معادلة وكل ادعاء يكتبه شخص أو يراجعه، ولا تُنشر أي صفحة قبل المراجعة الموضحة أعلاه. الأداة التي تنتج رقمًا معقولًا هي بالضبط نوع ما وُجد هذا الإجراء لالتقاطه.

الفحص الذي يكشف ذلك ليس بشريًا فقط. لدى محرك الحساب اختبارات وحدات تعمل مع كل تغيير وتمنع الإصدار إذا تحركت أي قيمة: يجب أن يساوي مجموع جدول السداد المبلغ المقترض، وأن ينتهي رصيد القرض عند الصفر بالضبط، وأن يتطابق التنبؤ لكل فترة مع المعادلة المغلقة عند كل تردد-prefixed تركيب. لا يمكن لنص سردي أن يفشل بهذه الطريقة. يمكن للمعادلة أن تفشل، وعندما يحدث ذلك يتوقف البناء.

تواريخ المراجعة

يحمل كل دليل تاريخ آخر مراجعة له. ويُراجع الدليل الذي يعتمد محتواه على بيانات خارجية مرتين على الأقل في السنة؛ ويُراجع الدليل الذي يشرح عملية حسابية عند تغيير المعادلة الكامنة وراءه، وفي جميع الحالات مرة واحدة في السنة. وعند مراجعة الصفحة يُحدَّث التاريخ، سواء تغير النص أم لا، ليخبرك التاريخ بآخر مرة قرأ فيها شخص الصفحة.

التصحيحات

تُجرى التصحيحات بشكل علني. تحتفظ الصفحة التي تم تصحيحها بتاريخ مراجعة محدَّث، ويُوصف التصحيح في سلسلة الرسائل التي جاء منها. والدليل الذي يتضمن رقمًا خاطئًا يمثل خللًا في المراجعة لا في الكتابة، وعملية المراجعة هي ما يغيّره.