Cách chúng tôi viết

Trả lời nhanh#

• Thông tin về Belvador được kiểm với code và docs; con số đến từ các lần chạy có ghi lại.

• Thông tin về sản phẩm khác dẫn trang công khai của họ, kèm ngày chúng tôi đọc.

• Code mẫu được chạy thử trước khi đăng, dùng placeholder thay cho khoá thật.

• Công cụ AI hỗ trợ soạn nháp, dịch và một số hình minh hoạ; một biên tập viên có tên kiểm tra và chịu trách nhiệm cho từng trang.

• Chỗ sai được sửa ngay trên trang, kèm ngày cập nhật.

Chọn chủ đề#

Chúng tôi viết về những vấn đề người ta mang tới công cụ theo dõi lỗi: cron job ngừng chạy, lỗi chỉ xảy ra trên production, AI agent hỏng mà không báo gì, hoá đơn tăng theo traffic. Một chủ đề cần có câu hỏi thật phía sau và thứ chúng tôi chỉ ra được — một lệnh, một cấu hình, một phép đo.

Kiểm thông tin#

• Hành vi của Belvador được kiểm với mã nguồn và docs. Giới hạn và giá được hiển thị từ chính cấu hình mà sản phẩm áp dụng, nên không thể lệch khỏi nó.

• Sản phẩm khác được mô tả từ docs và trang giá của chính họ, kèm link và ngày chúng tôi đọc. Trang so sánh nói rõ khi nào sản phẩm kia là lựa chọn tốt hơn.

• Con số đến từ các lần chạy có ghi lại, kèm máy, phiên bản và ngày (benchmark). Thứ gì chưa đo, chúng tôi nói là chưa đo.

Thử code#

Code được chạy trên một project thử trước khi đăng, và trang ghi các phiên bản đã dùng khi điều đó quan trọng. Khoá, token và email trong ví dụ là placeholder như <public-key>. Các bước cài đặt trên trang sản phẩm được tạo từ cùng nguồn với docs và app, nên bước bạn thấy ở đây chính là bước app hiện ra.

Công cụ AI#

Chúng tôi dùng công cụ AI để soạn nháp, dịch giữa tiếng Anh và tiếng Việt, và cho một số hình minh hoạ. Sau đó mỗi trang được một biên tập viên có tên chỉnh sửa và kiểm tra, và người đó chịu trách nhiệm cho trang. Chúng tôi không viết để qua mặt công cụ phát hiện AI; chúng tôi biên tập cho đúng và dễ hiểu. Logo Belvador trong hình luôn là file logo thật, không bao giờ để mô hình vẽ.

Tiếng Anh và tiếng Việt#

Hai bản được viết cho người đọc của từng bản, không dịch từng chữ. Thuật ngữ mà dev quen dùng bằng tiếng Anh — DSN, issue, stack trace — được giữ nguyên trong trang tiếng Việt.

Link#

Link dẫn tới trang docs giải thích một bước, trang sản phẩm mô tả một tính năng, và nguồn gốc: đặc tả, docs của nhà cung cấp, release note. Chúng tôi không mua link và không đặt link trả tiền trong bài viết.

Đính chính#

Nếu có gì sai hoặc đã cũ, viết cho hello@belvador.dev kèm địa chỉ trang. Chúng tôi sửa trên trang và đổi ngày cập nhật. Vấn đề bảo mật gửi về địa chỉ trên trang bảo mật.