Chọn một người viết kỹ thuật

Giai đoạn hiện tại:
Phát triển tài liệu. 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 người viết nội dung kỹ thuật cho đề xuất dự án trong Google Season of Tài liệu.

Giới thiệu

Tổ chức nguồn mở phải thuê một người viết nội dung kỹ thuật để thực hiện dự án đề xuất. Các tổ chức phải có nguồn thông tin về người viết nội dung kỹ thuật của riêng mình. 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 Google Season of Tài liệu có trong kho lưu trữ Google Season of Tài liệu trên GitHub và trong kênh#season-of-docs của Slack Viết Tài liệu.

Bắt đầu quy trình

Bạn nên bắt đầu quá trình tìm người viết nội dung kỹ thuật ngay khi nghĩ rằng có thể mình sẽ muốn tham gia phần Google Tài liệu.

Đánh giá một người viết nội dung kỹ thuật

Bạn nên yêu cầu ví dụ về tài liệu đã phát triển trước đó từ các tác giả kỹ thuật mà bạn đang cân nhắc để có thể đánh giá kỹ năng và kinh nghiệm 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 nội dung kỹ thuật. Tốt nhất là người viết nội dung kỹ thuật nên có một số kinh nghiệm trong 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 Google Mùa Tài liệu là mang đến cho người viết nội dung kỹ thuật cơ hội tham gia vào các sản phẩm tập trung vào nhà phát triển. Do đó, người viết không nhất thiết phải có kinh nghiệm với API hoặc SDK hay các nền tảng khác dành cho nhà phát triển, 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 ngôn ngữ và kỹ năng giao tiếp. Từ quan điểm này, hãy đánh giá tác phẩm trước đây của người viết nội dung kỹ thuật. Quan trọng nhất là: Bạn có thể hiểu được người đó viết gì không? Nếu bạn muốn đánh giá chuyên sâu về ngôn ngữ trong tác phẩm của tác giả kỹ thuật, hãy tìm tính nhất quán về dấu câu và diễn đạt, chính tả đúng và ngôn từ rõ ràng. Cụm từ đó đơn giản hay phức tạp? Các câu có ngắn hay chạy liên tục cho đến khi trở nên khó theo dõi?

  • 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 ra tài liệu hoặc bộ tài liệu không? Có nội dung trùng lặp hay có khoảng trống rõ ràng không?

Thuê người viết nội dung kỹ thuật

Các tổ chức phải thuê một người viết kỹ thuật và hoàn tất Biểu mẫu tuyển dụng nhân viên viết nội dung kỹ thuật theo đường liên kết bên dưới, chậm nhất vào 18:00 ngày 22 tháng 5 năm 2024 (giờ UTC).

Biểu mẫu bằng chứng về việc tuyển dụng nhân viên hỗ trợ kỹ thuật

Hãy nhớ thảo luận về mức thù laolịch thanh toán với nhân viên kỹ thuật trước khi tuyển dụng. Các tổ chức nên tạo lịch thanh toán với người 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 (sẽ chỉ xuất hiện 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à viết công nghệ và đã gửi Biểu mẫu tuyển dụng kỹ thuật viên trước 18:00 ngày 22 tháng 5 năm 2024 (giờ UTC), sẽ không được nhận tiền vào ngày giải ngân đầu tiên.