Giai đoạn hiện tại:
Kết quả đã được công bố. Xem tiến trình.
Trang này cung cấp các mẹo dành cho các tổ chức nguồn mở về cách đánh giá và chọn người viết nội dung kỹ thuật phù hợp cho đề xuất dự án Google Season of Docs.
Giới thiệu
Tổ chức nguồn mở phải thuê một người viết kỹ thuật để làm việc trên dự án đề xuất của họ. Các tổ chức phải tự tìm nguồn nhà văn kỹ thuật. Những người viết nội dung kỹ thuật quan tâm đến việc hợp tác với các tổ chức tham gia vào Google Season of Tài liệu có thể được tìm thấy trong kho lưu trữ GitHub của Google Season of Docs và #season-of-docs trong Slack Write the Tài liệu.
Bắt đầu quy trình
Bạn nên bắt đầu tìm kiếm một nhà văn kỹ thuật ngay khi bạn nghĩ rằng mình có thể muốn tham gia Google Season of Docs.
Đánh giá nhân viên viết tài liệu kỹ thuật
Bạn nên yêu cầu các ví dụ về tài liệu đã phát triển trước đây của những người viết nội dung kỹ thuật mà bạn đang cân nhắc sử dụng. Nhờ đó, bạn có thể tập trung vào việc đánh giá kinh nghiệm và kỹ năng viết kỹ thuật của họ.
Kỹ năng và kinh nghiệm viết kỹ thuật
Kiểm tra kinh nghiệm trước đây của người viết tài liệu kỹ thuật. Tốt nhất là người viết kỹ thuật nên có kinh nghiệm trước về việc viết tài liệu kỹ thuật cho ngành phần mềm. Một trong những mục tiêu của Phần Tài liệu của Google là tạo cơ hội cho những người viết nội dung kỹ thuật tham gia vào các sản phẩm dành cho nhà phát triển. Vì lý do đó, không nhất thiết là người viết phải có kinh nghiệm về API, SDK hoặc các nền tảng dành cho nhà phát triển khác, ngay cả khi dự án của bạn tập trung vào đối tượng nhà phát triển.
Tập trung vào kỹ năng ngôn ngữ và giao tiếp. Đánh giá công việc trước đây của người viết nội dung kỹ thuật từ quan điểm này. Quan trọng nhất: Bạn có hiểu được nội dung người đó viết không? Nếu bạn muốn xem xét kỹ lưỡng ngôn ngữ của tác phẩm của người viết kỹ thuật, hãy tìm sự nhất quán trong dấu câu và cách diễn đạt, chính tả chính xác và ngôn ngữ rõ ràng. Cách diễn đạt đơn giản hay phức tạp? Các câu này ngắn hay lặp lại cho đến khi khó hiểu?
Chú ý đến thiết kế và bố cục của tài liệu. Kiểm tra bố cục tổng thể của(các) mẫu tài liệu. Thiết kế có hợp lý không? Bạn có thể dễ dàng tìm thấy tài liệu hoặc bộ tài liệu không? Nội dung có bị trùng lặp không hay có khoảng trống rõ ràng nào không?
Thuê người viết tài liệu kỹ thuật
Các tổ chức phải thuê một người viết nội dung kỹ thuật và hoàn tất Biểu mẫu bằng chứng về việc thuê người viết nội dung kỹ thuật được liên kết bên dưới muộn nhất vào 18:00 (giờ UTC) ngày 10 tháng 5 năm 2023.
Đã hoàn tất giai đoạn tuyển dụng nhân viên viết nội dung kỹ thuật.
Hãy nhớ thảo luận về mức thù lao và lịch thanh toán với nhà văn kỹ thuật trước khi tuyển dụng. Các tổ chức nên lập lịch thanh toán với các chuyên gia viết nội dung kỹ thuật dựa trên các mốc quan trọng của dự án, bao gồm cả việc thanh toán khi bắt đầu dự án. Xin lưu ý rằng ngày thanh toán chỉ diễn ra hai lần trong suốt chương trình và số tiền khi tạo lịch thanh toán.
Lưu ý: Những tổ chức chưa thuê nhà văn kỹ thuật và gửi Biểu mẫu bằng chứng về việc thuê nhà văn kỹ thuật muộn nhất vào lúc 18:00 (giờ UTC) ngày 10 tháng 5 năm 2023 sẽ không nhận được tiền vào ngày thanh toán đầu tiên.