Hướng dẫn cho người viết kỹ thuật

Giai đoạn hiện tại:
Chương trình Season of Docs 2021 đã kết thúc vào ngày 14 tháng 12 năm 2021. Xem tiến trình.

Hướng dẫn này dành cho các nhà văn kỹ thuật muốn làm việc với các tổ chức được chấp nhận trong chương trình Google Season of Docs 2021.

Bạn có nên tham gia chương trình Google Season of Docs 2021 không?

Hãy dùng những câu hỏi này để giúp bạn biết liệu bạn có muốn hợp tác với một tổ chức được chấp nhận trong chương trình Google Season of Docs 2021 hay không.

  • Bạn có kỹ năng và kinh nghiệm viết tài liệu kỹ thuật không? Season of Docs không nhằm mục đích dạy các kỹ năng viết kỹ thuật cơ bản. Bạn có tự động viên và có tính tổ chức không?
  • Bạn có thời gian tham gia trong 6 tháng diễn ra chương trình (tháng 4 đến tháng 11 năm 2021) không? Quy mô dự án khác nhau, nhưng bạn sẽ phải cam kết dành từ 5 đến 30 giờ mỗi tuần trong suốt chương trình.
  • Bạn có muốn tích luỹ kinh nghiệm làm việc trong lĩnh vực nguồn mở không? Bạn có sẵn sàng dành thời gian tìm hiểu quy trình của dự án và các quy tắc của cộng đồng không?
  • Bạn có sẵn sàng làm việc với quản trị viên tổ chức để tinh chỉnh các đề xuất dự án, phát triển tiến trình, đánh giá và biên soạn các chỉ số, đồng thời giúp toàn bộ tổ chức hiểu được giá trị của việc viết tài liệu kỹ thuật không?

Bạn cũng phải đáp ứng các yêu cầu về điều kiện tham gia chương trình, bao gồm cả việc có thể tạo tài khoản Open Collective. Xin lưu ý rằng bạn phải có quyền hợp pháp để nhận tiền cho công việc thực hiện tại nơi cư trú của bạn. Quản trị viên chương trình Season of Docs không thể tư vấn về thuế hoặc trả lời các câu hỏi về việc bạn có đủ điều kiện làm việc hay không.

Là một nhà văn kỹ thuật có kỹ năng tham gia Google Season of Docs, bạn sẽ được trả tiền để có được kinh nghiệm làm việc trong nguồn mở, đồng thời giúp dự án của mình giải quyết một nhu cầu chính thông qua tài liệu tốt hơn.

Tham gia chương trình Season of Docs 2021 với vai trò là nhà văn kỹ thuật

Giai đoạn khám phá

Chúng tôi sẽ ngừng nhận đơn đăng ký của tổ chức vào lúc 18:00 (giờ UTC) ngày 26 tháng 3 năm 2021. Nhà văn kỹ thuật nên bắt đầu tìm hiểu các dự án có thể thực hiện càng sớm càng tốt. Tuy nhiên, các tổ chức có thể chọn cộng tác với các nhà văn kỹ thuật bất cứ lúc nào trước 18:00 (giờ UTC) ngày 17 tháng 5 năm 2021.

  • Tìm các dự án mà bạn quan tâm
    • Hãy liên hệ trực tiếp với các tổ chức nguồn mở theo hướng dẫn trên trang chương trình Google Season of Docs của họ hoặc xem kho lưu trữ GitHub của Google Season of Docs để tìm những tổ chức đã bày tỏ sự quan tâm đến việc tham gia Google Season of Docs. Bạn cũng có thể tìm thấy các tổ chức quan tâm trong kênh #season-of-docs trong nhóm Write the Docs trên Slack.
    • Một số cách chọn dự án:
      • Chọn một dự án bằng ngôn ngữ mà bạn quen thuộc hoặc quan tâm, chẳng hạn như Javascript hoặc C.
      • Chọn một dự án trong một công nghệ hoặc lĩnh vực mà bạn quan tâm, chẳng hạn như học máy, khoa học mở hoặc robot.
      • Hãy chọn một dự án dựa trên mức độ thân thiện của cộng đồng! Tìm hiểu các diễn đàn thảo luận của họ, xem tài khoản mạng xã hội của các cộng tác viên (nếu họ nói về dự án của mình trên đó) và xem tài liệu giới thiệu của họ (nếu có).
      • Nếu có một dự án mà bạn muốn hợp tác nhưng không có trong danh sách dự án, hãy liên hệ với dự án đó và đề nghị họ cân nhắc đăng ký!
  • Xem các trang đề xuất của dự án
    • Sau khi bạn có 3 đến 5 dự án tiềm năng, hãy xem trang đề xuất của từng dự án
    • Bạn nên đặt câu hỏi, đưa ra ý kiến phản hồi và đề xuất thông qua các kênh mà dự án đã liệt kê để phản hồi và thảo luận
  • Gửi tuyên bố quan tâm trực tiếp đến tổ chức. Trong tuyên bố quan tâm, bạn sẽ cho thấy cách bạn sẽ đạt được các mục tiêu được nêu trong đề xuất dự án của tổ chức.
    • Sử dụng mẫu tuyên bố quan tâm của Google Season of Docs. Càng ngắn càng tốt!
    • Hãy làm theo hướng dẫn trên trang ý tưởng của tổ chức để gửi tuyên bố về mong muốn của bạn. Nếu tổ chức đó liệt kê bất kỳ yêu cầu đặc biệt nào, hãy đảm bảo bạn cho thấy rằng bạn đáp ứng các yêu cầu đó trong tuyên bố của mình.
    • Bằng việc gửi tuyên bố quan tâm, bạn đồng ý tuân thủ quy tắc ứng xử của tổ chức và quy tắc ứng xử của chương trình Season of Docs.

Giai đoạn ứng dụng

  • Chờ thông báo của Google về các tổ chức được chấp nhận tham gia chương trình Season of Docs:
    • Những tổ chức được chấp nhận sẽ liên hệ trực tiếp nếu họ muốn hợp tác với bạn hoặc thảo luận thêm về tuyên bố quan tâm của bạn.
    • Các tổ chức không chỉ được làm việc với những người viết nội dung kỹ thuật đã gửi tuyên bố quan tâm trước thời hạn đăng ký của tổ chức. Sau khi chấp nhận, họ có thể yêu cầu bạn cung cấp thêm tuyên bố về mối quan tâm. Các tổ chức phải chọn một người viết nội dung kỹ thuật trước 18:00 (giờ UTC) ngày 17 tháng 5 năm 2021.
    • Các tổ chức không bắt buộc phải đưa ra ý kiến phản hồi về những tuyên bố quan tâm không thành công.

Giai đoạn phát triển dự án

  • Làm việc với tổ chức để tạo lịch trình, bao gồm cả các sản phẩm và thời hạn.

Giai đoạn đánh giá cuối cùng và nghiên cứu điển hình

  • Làm việc với tổ chức để cung cấp thông tin cần thiết cho quá trình đánh giá cuối cùng và nghiên cứu điển hình.