- Được phát triển để biến các đoạn mã trong tài liệu thành thứ thực sự có thể chạy được, qua đó nâng cao tính hữu dụng/độ tin cậy của runbook, tài liệu vận hành và README
- Có thể thực thi nguyên trạng các khối mã trong Markdown, giúp dễ dàng làm theo tài liệu theo từng bước và kiểm chứng
- Chạy lệnh, kiểm tra kết quả trung gian và xác nhận xem đầu ra mong muốn đã đạt được hay chưa
- Hỗ trợ nhiều runtime dựa trên shebang như Shell/Bash, Python, JavaScript/TypeScript, Ruby, v.v.
- Khi chạy các ô mã, duy trì biến môi trường và ngữ cảnh thực thi, cho phép thực hiện từng bước như trong một phiên terminal
- Cũng hỗ trợ luồng thực thi dạng pipeline để truyền đầu ra của ô trước sang ô tiếp theo
- Tương thích hoàn toàn với các định nghĩa tác vụ hiện có như Makefile, npm scripts, Gradle, Deno task
- Thông qua các lệnh
run, list, print, có thể khám phá, chạy và kiểm chứng các quy trình làm việc có thể thực thi trong tài liệu
- Giảm vấn đề bitrot trong tài liệu vận hành và đặc biệt phù hợp với các tài liệu thực tế cần thực thi theo từng bước
- bitrot: hiện tượng tài liệu hoặc mã dần lệch khỏi môi trường thực tế theo thời gian và ngày càng mất độ tin cậy
- Có thể cài đặt bằng Homebrew, npm, Go install, binary đơn, v.v.
- Giấy phép Apache 2.0
Chưa có bình luận nào.