Video hay tài liệu viết: khi nào nên quay, khi nào nên viết

Nhóm nào rồi cũng gặp đúng cuộc tranh luận ấy. Người này bảo “quay nhanh một video là xong”, người kia bảo “cái này phải viết thành tài liệu”, rồi công việc nằm im cả tuần trong lúc hai bên chờ một phán quyết.

Câu trả lời không nằm ở chỗ định dạng nào tốt hơn. Video và chữ viết thất bại ở những chỗ khác nhau. Video vô địch khi cần cho thấy chuyển động, trình tự và khả năng phán đoán. Chữ viết vô địch khi cần lướt nhanh, tìm kiếm và chỉnh sửa. Chọn sai, bạn hoặc chôn một câu trả lời hai dòng vào giữa đoạn ghi hình tám phút, hoặc mất cả buổi chiều để mô tả bằng lời một thao tác kéo thả.

Bài viết này đưa ra cách quyết định lặp lại được, chỉ mất khoảng ba mươi giây, trước khi bạn bắt tay vào làm.

Bài kiểm tra ba mươi giây

Hãy đặt ba câu hỏi về thứ bạn định ghi lại.

1. Nó có chuyển động không? Nếu muốn hiểu thì phải nhìn thấy điều gì đó diễn ra — đường đi của con trỏ, một lần chuyển trạng thái, một hiệu ứng động, một công cụ phản hồi theo thời gian thực — hãy quay lại.
2. Sau này có ai chỉ cần đúng một phần trong đó không? Nếu mọi người sẽ quay lại tra một giá trị, một tùy chọn hay một bước cụ thể, hãy viết ra. Không ai kéo thanh thời gian chỉ để tìm một số cổng.
3. Nó thay đổi thường xuyên đến mức nào? Nếu màn hình thay đổi hằng tháng, viết sẽ rẻ hơn để duy trì. Nếu nó ổn định cả năm, video đáng đồng tiền bát gạo.

Hai câu trả lời nghiêng về “video” thì hãy quay. Hai câu nghiêng về “chữ” thì hãy viết. Nếu hòa, nhiều khả năng bạn cần cả hai — điều này dễ hơn bạn nghĩ.

Khi video thắng

Trình bày một quy trình trải qua nhiều công cụ. Phần khó của hầu hết quy trình không nằm ở cú nhấp nào cả, mà ở những gì xảy ra giữa các ứng dụng. Bản ghi giữ lại trọn vẹn lộ trình mà bạn không phải mô tả sáu lần chuyển ngữ cảnh.

Mọi thứ cần phán đoán bằng mắt. “Làm cho khoảng cách cân đối hơn”, “hiệu ứng này nhanh quá”, “biểu đồ cần thoáng hơn”. Không thể diễn đạt chính xác bằng chữ, nhưng hiển nhiên trong mười giây video.

Báo lỗi và tái hiện lỗi. Bản ghi cho thấy đúng trình tự, đúng thời điểm và đúng trạng thái. Nó xóa sạch màn qua lại “bên tôi không tái hiện được”.

Nhận việc và ấn tượng đầu tiên. Đồng nghiệp mới cần thấy sự thành thạo trông ra sao: một việc nên mất bao lâu, người có kinh nghiệm khựng lại ở đâu, họ bỏ qua những gì. Các bước viết ra làm phẳng hết những điều đó.

Bất cứ điều gì mà nếu không quay bạn sẽ phải giải thích trực tiếp ba lần. Nếu bạn đã nói cùng một chuyện trong ba cuộc họp, thứ cần thiết là một bản ghi, không phải cuộc họp thứ tư.

Truyền đạt sắc thái. Góp ý, những quyết định có nhiều tầng nghĩa, và bất cứ điều gì dễ bị đọc thành cộc lốc đều được tiếp nhận tốt hơn nhiều khi có giọng nói và gương mặt đi kèm.

Khi chữ viết thắng

Tài liệu tra cứu. Giá trị cấu hình, tham số API, phím tắt, mã lỗi. Tất cả những gì người ta tra chứ không học.

Mọi thứ cần tìm kiếm được. Chữ viết được lập chỉ mục bởi wiki, trung tâm trợ giúp và công cụ tìm kiếm. Video là một hộp đen chừng nào bạn chưa thêm bản chép lời.

Các bước thay đổi thường xuyên. Sửa một dòng trong tài liệu mất vài giây. Quay lại một đoạn, khớp âm thanh rồi xuất lại mất cả tiếng — và mỗi khung hình lỗi thời lại bào mòn niềm tin vào toàn bộ thư viện.

Nội dung cần xem trong lúc làm. Không ai muốn một tay chạy migration, một tay tạm dừng, tua lại rồi phát tiếp video. Danh sách kiểm tra sinh ra để đọc.

Pháp lý, tuân thủ và mọi thứ đòi hỏi câu chữ chính xác. Nếu độ chính xác quan trọng hơn sự dễ hiểu, hãy viết, rà soát và quản lý phiên bản.

Nội dung phải dịch nhiều. Chữ viết dịch sang mười bốn ngôn ngữ với chi phí thấp. Thu âm lại lời dẫn thì không.

Định dạng mà hầu hết các nhóm thực sự cần

Tài liệu tốt nhất hiếm khi chỉ là một trong hai. Đó là một bản ghi ngắn dựa trên bộ khung bằng chữ.

Một khuôn mẫu đáng tin cậy:

• Một trang viết làm nguồn thông tin chuẩn. Tiêu đề, mục đích, điều kiện tiên quyết, các bước đánh số, và mọi giá trị chính xác ở dạng chữ có thể sao chép.
• Một bản ghi hai đến bốn phút nhúng ở gần đầu trang. Nó cho thấy hình dung tổng thể về công việc để người đọc biết mình sắp làm gì.
• Dấu chương và mốc thời gian để video trở nên dễ điều hướng thay vì tuyến tính.
• Bản chép lời hoặc phụ đề để nội dung video có thể tìm kiếm và dễ tiếp cận hơn.

Ai cần nắm tổng thể thì xem. Ai cần một giá trị thì lướt. Không nhóm nào bị thiệt vì lựa chọn của nhóm kia.

Giữ bản ghi đủ ngắn để còn đúng lâu dài

Lý do lớn nhất khiến tài liệu video mục ruỗng là độ dài. Một bản ghi hai mươi phút bao trùm tám chủ đề sẽ phải làm lại toàn bộ khi một chủ đề thay đổi. Tám bản ghi ba phút thì thay từng cái một.

Vài quy tắc thực tế giúp thư viện video luôn bảo trì được:

• Một video, một kết quả. Nếu tiêu đề cần chữ “và”, hãy tách ra.
• Hướng tới dưới năm phút. Phần lớn phần giải thích quy trình gói gọn trong ba phút.
• Đừng quay những phần thay đổi nhanh nhất. Giá cả, ngày tháng, tên nhóm và chữ trên giao diện nên nằm ở phần chữ bên cạnh video.
• Nói rõ phiên bản, hoặc hiển thị nó lên màn hình. Câu “bản ghi này thực hiện trên phiên bản 4.2” biến một video lỗi thời thành một video có mốc thời gian, ít gây hại hơn nhiều.
• Quay sạch. Bật Không làm phiền, dùng dữ liệu demo thay vì hồ sơ khách hàng thật, giữ một giao diện nhất quán. Một đoạn dùng lại được ở ba nơi giá trị hơn ba đoạn không dùng lại được.

Giảm chi phí của việc quay

Phần lớn quyết định “thôi viết ra cho rồi” thực chất có nghĩa là “quay video cảm giác như làm cả một sản phẩm”. Hạ chi phí đó xuống sẽ thay đổi bài toán cho cả nhóm.

• Bỏ phần mở đầu. Bắt đầu ngay ở màn hình quan trọng. Tài liệu nội bộ không cần mười lăm giây rào đón.
• Đừng viết kịch bản từng chữ. Ghi năm gạch đầu dòng rồi nói theo. Kịch bản khiến giọng nghe như đang đọc và làm thời gian chuẩn bị tăng gấp ba.
• Sửa bằng cách cắt, không phải quay lại. Cắt khoảng lặng, câu nói vấp và đoạn chờ tải lâu. Gần như bản quay nào cũng cứu được.
• Dùng thu phóng thay cho lời dẫn. Phóng to vào nút bạn vừa bấm sẽ thay thế câu giải thích nút đó nằm ở đâu.
• Một bản quay ổn là đủ. Tài liệu nội bộ không cần đến lần thử thứ tư. Cứ đăng đi.

Một quy ước đơn giản cho nhóm

Nếu muốn chấm dứt cuộc tranh luận này, hãy viết ra bốn dòng:

1. Tra cứu và cấu hình → chữ viết. Luôn luôn.
2. Quy trình, demo và góp ý → video. Dưới năm phút.
3. Mọi thứ dùng trong lúc làm việc → danh sách kiểm tra bằng chữ, kèm video tổng quan tùy chọn.
4. Mọi thứ thay đổi nhiều hơn mỗi quý một lần → chữ viết, trừ khi phần hình ảnh chính là trọng tâm.

Rồi thêm một quy tắc quan trọng hơn cả bốn điều trên: mỗi video đều phải có tiêu đề bằng chữ, một câu tóm tắt và một liên kết từ tài liệu liên quan. Bản ghi mà không ai tìm thấy là bản ghi chưa từng tồn tại.

Lời kết

Chọn định dạng không phải là chuyện gu thẩm mỹ — đó là một quyết định về bảo trì mà bạn đưa ra thay cho tất cả những người sẽ đọc công việc của bạn sau sáu tháng nữa. Video mua lấy sự thấu hiểu. Chữ viết mua lấy độ bền. Những nhóm có tài liệu tốt nhất không phải là nhóm đã chọn phe. Đó là nhóm đã ngừng tranh cãi, quay lại những gì đáng xem, viết ra những gì đáng tra cứu, và nối hai thứ ấy lại với nhau.