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