Giai đoạn hiện tại:
Kết quả đã công bố
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 kỹ thuật phù hợp cho đề xuất dự án Mùa Tài liệu.
Giới thiệu
Các tổ chức nguồn mở phải thuê một người viết kỹ thuật để thực hiện dự án mà họ đề xuất. Các tổ chức phải có nguồn gốc từ người viết kỹ thuật của riêng mình. Các nhà viết kỹ thuật quan tâm đến việc hợp tác với các tổ chức tham gia vào Phần Tài liệu có thể được tìm thấy trong kho lưu trữ Phần Tài liệu trên GitHub và trong kênh#mùa-tài liệu của Slack viết Tài liệu.
Bắt đầu quá 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 bạn cho rằng có thể bạn sẽ muốn tham gia Phần 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ề các 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 để có thể tập trung đá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 kỹ thuật. Tốt nhất là người viết kỹ thuật nên có một số kinh nghiệm 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 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 dành cho nhà phát triển. Do đó, người viết không nhất thiết phải có kinh nghiệm về API hoặc SDK hoặc các nền tảng 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 ngôn ngữ và kỹ năng giao tiếp. Từ góc nhìn 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: Bạn có thể hiểu được người đó viết gì không? Nếu bạn muốn đánh giá sâu về ngôn ngữ trong tác phẩm của nhà văn kỹ thuật, hãy đảm bảo tính nhất quán trong dấu câu và cụm từ, cách viết đúng chính tả và ngôn từ rõ ràng. Cách diễn đạt đơn giản hay phức tạp? Các câu có ngắn hay dài cho đến khi trở nên khó theo dõi không?
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 hoặc có khoảng trống rõ ràng không?
Thuê một người viết nội dung kỹ thuật
Các tổ chức phải thuê người viết nội dung kỹ thuật và hoàn tất Biểu mẫu tuyển dụng bằng chứng về kỹ thuật theo đường liên kết bên dưới, chậm nhất vào 18:00 ngày 16 tháng 5 năm 2022 (giờ UTC).
Hoàn tất giai đoạn tuyển dụng biên tập viên kỹ thuật.
Hãy nhớ thảo luận về mức thù lao và lịch thanh toán với nhân viên hỗ trợ 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 (chỉ xảy ra 2 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ê người viết công nghệ và gửi Biểu mẫu tuyển dụng người viết kỹ thuật chậm nhất vào 18:00 ngày 16 tháng 5 năm 2022 (giờ UTC) sẽ không nhận được tiền vào ngày giải ngân đầu tiên.