Giai đoạn hiện tại:
Nghiên cứu điển hình đã xuất bản. Xem tiến trình.
Trang này trình bày một số câu hỏi cần cân nhắc khi tạo thoả thuận với nhà văn kỹ thuật cho chương trình Google Season of Docs. Đây không phải là ý kiến tư vấn pháp lý hoặc danh sách đầy đủ tất cả các điểm có thể cân nhắc khi tạo thoả thuận ghi nhận kỹ thuật cho các dự án nguồn mở. Tuỳ thuộc vào nhu cầu của tổ chức hoặc dự án, bạn nên tham khảo ý kiến của cố vấn pháp lý riêng trước khi tuyển dụng một người viết nội dung kỹ thuật.
Phạm vi công việc
- Tạo danh sách các tác phẩm thuộc phạm vi thoả thuận của bạn. Hãy nêu càng cụ thể càng tốt. Ví dụ: thay vì "Tài liệu API", hãy tạo danh sách các điểm cuối cần được ghi lại và thông tin cần có, chẳng hạn như lệnh curl mẫu hoặc danh sách tham số.
- Làm cách nào để biết một nội dung đã "hoàn tất"?
- Những điều khác cần cân nhắc:
- Ai sẽ sở hữu bản quyền đối với tác phẩm? Ứng dụng sẽ được phát hành theo giấy phép nào (các giấy phép này khác nhau!)? Người viết nội dung kỹ thuật sẽ nhận được giá trị đóng góp nào (được đề cập trên trang web, được liệt kê là cộng tác viên, v.v.)? Nếu sau này nội dung cần được cấp phép lại thì sao? Ví dụ: nếu bạn muốn người viết nội dung kỹ thuật ký thoả thuận cấp phép cho người đóng góp của dự án nguồn mở, bạn nên thông báo điều đó.
- Nếu bạn muốn người viết nội dung kỹ thuật tham gia nhiều lần sửa đổi, hãy nêu rõ điều đó. Ví dụ: bạn có thể nêu rõ rằng bạn muốn nhận bản nháp đầu tiên, sau đó là bản nháp thứ hai để giải quyết các vấn đề kỹ thuật, rồi đến bản nháp cuối cùng để đọc lại.
- Nếu bạn muốn người viết nội dung kỹ thuật cung cấp nội dung ở một định dạng cụ thể, chẳng hạn như Markdown, hãy đưa điều này vào thoả thuận của bạn.
- Dự án của bạn có nguyên tắc sử dụng AI tạo sinh để tạo tài liệu hoặc mã không? Hãy đảm bảo rằng các nguyên tắc đó được chia sẻ với nhà văn kỹ thuật của bạn.
Bồi thường
- Đồng ý với người viết nội dung kỹ thuật về lịch thanh toán liên quan đến các ngày và sản phẩm cụ thể.
- Bạn có thanh toán trước một khoản tiền khi bắt đầu công việc không?
- Điều gì sẽ xảy ra nếu không thể sử dụng hoặc chấp nhận công việc (vì các ưu tiên của dự án đã thay đổi hoặc vì một người đánh giá đã bỏ ngang, v.v.)? Bạn có thể trả "phí huỷ" để bù cho thời gian mà người viết kỹ thuật đã bỏ ra không?
- Ai sẽ chịu trách nhiệm đối với mọi khoản phí chuyển đổi tiền tệ liên quan đến phương thức thanh toán đã chọn?
Liên lạc
- Bạn có mong đợi người viết nội dung kỹ thuật có thể tham gia cuộc gọi video hoặc cuộc họp không?
- Bạn sẽ sử dụng những kênh giao tiếp nào và thời gian phản hồi dự kiến là bao lâu? Ví dụ: nếu bạn muốn nhà văn kỹ thuật phản hồi email (hoặc thông báo trong Slack) trong vòng một ngày, hãy nêu rõ điều đó.
- Người viết nội dung kỹ thuật có thể liên hệ với ai trong dự án để giải đáp các câu hỏi, chẳng hạn như vấn đề thanh toán, cần xem xét, giải quyết vấn đề chặn công cụ hoặc kênh hoặc các vấn đề chặn khác?
- Nhà văn có cần phải tuân theo quy trình cụ thể nào để gửi tác phẩm hoặc nhận ý kiến phản hồi hay bài đánh giá không?
Công cụ
- Người viết nội dung kỹ thuật cần sử dụng công cụ (hoặc phiên bản công cụ) nào để tạo nội dung?
- Ai chịu trách nhiệm giúp người viết nội dung kỹ thuật thiết lập, truy cập hoặc nhận quyền?
Giải quyết những điểm bất đồng
- Bạn sẽ giải quyết những bất đồng về chất lượng công việc của người viết nội dung kỹ thuật như thế nào? Ai có quyền quyết định cuối cùng?
- Quy trình để loại bỏ người viết nội dung kỹ thuật khỏi dự án sẽ như thế nào? Ví dụ: trễ hạn 3 lần liên tiếp hoặc nộp bài có chất lượng không chấp nhận được. Khi thực thi quy trình, hãy cân nhắc việc đưa ra các bước tiếp theo rõ ràng ("Chúng tôi dự kiến bạn sẽ gửi yêu cầu lấy dữ liệu cho bản nháp đầu tiên vào thứ Sáu tới" thay vì "Vui lòng gửi bài tập của bạn càng sớm càng tốt").
- Nếu một người viết nội dung kỹ thuật cần rút lui, họ nên thông báo như thế nào? Nếu có thể, họ có nên thông báo, tạo tài liệu chuyển giao hay thực hiện cuộc gọi chuyển giao không?
- Đừng quên xem xét các nghĩa vụ của dự án đối với người viết nội dung kỹ thuật. Ví dụ: nếu người cố vấn dự án của bạn rút lui và không thể thay thế, hoặc nếu không thể hoàn tất các bài đánh giá đã hứa, hãy cân nhắc thanh toán một phần số tiền còn lại cho người viết kỹ thuật ngay cả khi không thể hoàn tất dự án để bù đắp cho thời gian của họ.
- Nêu rõ rằng người viết nội dung kỹ thuật phải tuân thủ Quy tắc ứng xử của dự án và liên kết đến quy trình thực thi Quy tắc ứng xử của bạn. Bạn nên nêu rõ rằng các lỗi vi phạm CoC sẽ dẫn đến việc chấm dứt dự án và mất khoản thanh toán cho mọi công việc chưa hoàn thành.