Ban biên tập

Một người viết các hướng dẫn. Một người khác đọc nội dung tài chính của mỗi hướng dẫn trước khi nó được đăng tải. Trang này cho biết họ là ai, nội dung đánh giá kiểm tra những gì và bạn có thể tự kiểm tra những gì.

Tác giả

Kostan Proff

Làm việc trong lĩnh vực cơ sở hạ tầng CNTT — đám mây, CI/CD, cơ sở hạ tầng dưới dạng mã — nơi một thay đổi không thể xác minh sẽ không được triển khai. Giữ cho môi trường đám mây tinh gọn và các đường ống phân phối nhanh chóng là công việc hàng ngày; tiêu chuẩn tương tự cũng được áp dụng cho trang web này. Các phép tính nằm ở một nơi, các công thức được bao phủ bởi các bài kiểm tra đơn vị đối chiếu với các số liệu khoản vay đã công bố, và mọi số liệu từ bên ngoài đều ghi rõ nguồn và ngày truy xuất. Viết các hướng dẫn và duy trì công cụ tính toán.

GitHub

Người đánh giá tài chính

Tetiana Goncharko

Đọc nội dung tài chính của một hướng dẫn trước khi nó được xuất bản: các con số, các giả định đằng sau chúng và các nguồn mà chúng lấy từ đó. Tác giả xây dựng công cụ tính toán; người đánh giá đọc kết quả từ phía bên kia, phía của một người làm việc với tiền bạc thay vì mã nguồn. Tên của cô ấy chỉ xuất hiện trên các hướng dẫn mà cô ấy đã đánh giá.

LinkedIn

Những gì bạn có thể kiểm tra

Các phép tính được công khai

Mã nguồn đằng sau mỗi máy tính đều nằm trong một kho lưu trữ công khai, cùng với các công thức mà nó thực hiện, các bài kiểm tra đơn vị đối chiếu chúng với các số liệu đã công bố và các bước kiểm tra ngăn chặn việc phát hành khi trang bị lỗi. Bạn không cần phải tin tưởng vào các con số và bạn không cần phải hỏi.

Mở kho lưu trữ

Hai tên, hai công việc

Một người viết các hướng dẫn và duy trì công cụ tính toán. Một người khác đọc nội dung tài chính của hướng dẫn trước khi nó được xuất bản, kiểm tra các con số, các giả định đằng sau chúng và các nguồn mà chúng được lấy từ đó. Hai công việc này được tách biệt một cách có chủ đích: người viết hướng dẫn không phải là người đọc kiểm duyệt cuối cùng.

Khi một hướng dẫn nêu tên người đánh giá, đó là người đã đánh giá nó, và tên đó chỉ xuất hiện trên hướng dẫn đó chứ không xuất hiện ở nơi nào khác. Một bài đánh giá là một tuyên bố về một trang cụ thể, vì vậy nó được gắn với trang đó thay vì toàn bộ trang web.

Mọi thứ khác trên trang này mô tả những gì bài đánh giá kiểm tra và những gì người đọc có thể xác minh mà không cần hỏi bất kỳ ai.

Những gì bài đánh giá kiểm tra

Trước khi một hướng dẫn được xuất bản, người đánh giá luôn thực hiện theo cùng một danh sách:

  • Phép tính. Mọi công thức đều được đối chiếu với nguồn gốc của nó và ví dụ minh họa trong văn bản được tính toán lại từ đầu. Khi một con số xuất hiện trong mã, cả hai sẽ được so sánh với nhau.
  • Các đơn vị. Phần trăm so với số thập phân, tháng so với năm, đô la so với hàng nghìn. Hầu hết các sai sót trong một tài liệu tài chính đều là lỗi đơn vị.
  • Các trường hợp ngoại lệ. Lãi suất bằng không, kỳ hạn bằng không, giá trị âm. Mỗi trường hợp đều được kiểm tra để đưa ra câu trả lời hợp lý thay vì thông báo lỗi.
  • Cách diễn đạt. Trang này không được bảo người đọc phải làm gì. Nó giải thích ý nghĩa của một con số và những yếu tố mà nó phụ thuộc vào, rồi dừng lại ở đó. Một hướng dẫn đưa ra lời khuyên về một hành động sẽ được viết lại.
  • Các nguồn. Mỗi liên kết đều được mở, kiểm tra đối chiếu với tuyên bố đi kèm và ghi ngày tháng.

Cách sử dụng các công cụ soạn thảo

Các công cụ soạn thảo hỗ trợ việc viết văn bản. Chúng không quyết định nội dung của trang. Mọi con số, mọi công thức và mọi tuyên bố đều được viết hoặc kiểm tra bởi con người, và không có trang nào được đăng tải nếu chưa qua quy trình đánh giá nêu trên. Một công cụ tạo ra con số nghe có vẻ hợp lý chính là thứ mà quy trình này tồn tại để phát hiện.

Quy trình kiểm tra không chỉ dựa vào con người. Công cụ tính toán có các bài kiểm tra đơn vị chạy trên mỗi thay đổi và chặn việc phát hành nếu một con số bị thay đổi: lịch trình phải cộng dồn bằng đúng số tiền vay, khoản vay phải kết thúc ở mức chính xác bằng không, và dự báo theo từng kỳ phải khớp với công thức dạng đóng ở mọi tần suất lãi kép. Một đoạn văn bản không thể sai theo cách đó. Một công thức thì có thể, và khi điều đó xảy ra, quá trình xây dựng sẽ dừng lại.

Ngày đánh giá

Mỗi hướng dẫn đều ghi ngày được đánh giá lần cuối. Một hướng dẫn có nội dung phụ thuộc vào dữ liệu bên ngoài sẽ được đánh giá ít nhất hai lần một năm; một hướng dẫn giải thích về số học sẽ được đánh giá khi công thức đằng sau nó thay đổi, và trong mọi trường hợp là ít nhất mỗi năm một lần. Khi một trang được đánh giá, ngày tháng sẽ được cập nhật, bất kể văn bản có thay đổi hay không, vì vậy ngày tháng cho bạn biết thời điểm một người đọc trang đó lần cuối.

Đính chính

Các đính chính được thực hiện công khai. Một trang đã được đính chính sẽ giữ nguyên ngày đánh giá được cập nhật và nội dung đính chính được mô tả trong luồng liên hệ mà nó xuất phát. Một hướng dẫn có con số sai là lỗi trong khâu đánh giá, không phải lỗi trong khâu viết, và quy trình đánh giá là thứ cần thay đổi.