Câu hỏi thường gặp

Giai đoạn hiện tại:
Phát triển tài liệu. Xem tiến trình.

Giải pháp chung

Mùa Tài liệu của Google có phải là chương trình tuyển dụng không?

Không. Nếu bạn muốn làm việc cho Google, hãy truy cập vào trang web việc làm của Google.

Tổ chức của chúng tôi muốn tham gia vào Mùa Google Tài liệu, nhưng chúng tôi chưa biết phải bắt đầu từ đâu!

Hãy tham khảo danh sách toàn bộ ý tưởng cho dự án của chúng tôi! Bạn cũng có thể liên hệ với cộng đồng viết kỹ thuật (hãy thử

phần tài liệu trong

Viết Slack cho Tài liệu hoặc lên các kênh truyền thông xã hội để yêu cầu trợ giúp hoặc đề xuất).

Tổ chức có thể đề xuất những loại dự án nào?

Dưới đây là một số ý tưởng:

  • Xây dựng trang web tài liệu trên một nền tảng do người viết về kỹ thuật và tổ chức nguồn mở quyết định, đồng thời phát hành bộ tài liệu cơ bản ban đầu trên trang web. Sau đây là một số ví dụ về nền tảng:

  • Tái cấu trúc tài liệu hiện có của dự án nguồn mở để cải thiện trải nghiệm người dùng hoặc một cấu trúc thông tin dễ tiếp cận hơn.

  • Viết tổng quan khái niệm hoặc giới thiệu về một sản phẩm hoặc tính năng. Thông thường, một nhóm sẽ tạo tài liệu kỹ thuật từ dưới lên, kết quả là có rất nhiều chi tiết nhưng nhìn chung lại khó hiểu toàn bộ sản phẩm. Người viết nội dung kỹ thuật có thể khắc phục vấn đề này.

  • Tạo hướng dẫn cho trường hợp sử dụng quan trọng.

  • Tạo một bộ hướng dẫn cách làm tập trung cho một số công việc cụ thể.

  • Tạo hướng dẫn dành cho cộng tác viên, bao gồm thông tin cơ bản về cách bắt đầu với tư cách là người đóng góp cho dự án nguồn mở, cũng như mọi quy tắc liên quan đến thoả thuận cấp phép, quy trình yêu cầu lấy dữ liệu và xem xét, xây dựng dự án, v.v.

Video có thể là một dự án khả thi cho Phần Google Tài liệu không?

Có. Hãy đảm bảo các yêu cầu đối với video có phạm vi cụ thể và xin lưu ý rằng việc sản xuất một video chất lượng cao thường tốn rất nhiều thời gian và nguồn lực.

Kiểm tra tài liệu có phải là một dự án hợp lý cho Phần Google Tài liệu không?

Kiểm tra tài liệu là một dự án tuyệt vời dành cho Google Phần Tài liệu. Hãy lưu ý đến lượng tài liệu bạn đã có; nếu đã có nhiều tài liệu, bạn có thể cần phải giảm phạm vi (ví dụ: chỉ kiểm tra nội dung hướng dẫn). Nếu có ít hoặc không có tài liệu nào, bạn nên đưa việc tạo tài liệu còn thiếu có mức độ ưu tiên cao nhất vào dự án của mình.

Tổ chức và người viết nội dung kỹ thuật có thể dùng các mẫu tài liệu nào không?

Google Season of Tài liệu có một kho lưu trữ GitHub với một mẫu và danh sách kiểm tra để thực hiện các hoạt động kiểm tra tài liệu. Các mẫu khác sẽ được thêm vào khi chúng được tạo.

Dự án Good Tài liệu đang nỗ lực tạo ra một số mẫu tài liệu khả thi tối thiểu cho nguồn mở.

Các tổ chức có bắt buộc phải sử dụng tài liệu do người viết nội dung kỹ thuật tạo không?

Không. Đôi khi, các dự án không hoạt động như mong đợi hoặc các yêu cầu thay đổi. Chúng tôi không yêu cầu các tổ chức sử dụng tài liệu hoặc tài liệu khác tạo ra, nhưng chúng tôi kỳ vọng rằng đánh giá cuối cùng và nghiên cứu điển hình sẽ bao gồm nội dung thảo luận về lý do không sử dụng tài liệu và cách dự án đưa ra quyết định không sử dụng tài liệu hoặc các tài liệu khác.

Phần Google Tài liệu xuất hiện ở đâu?

Phần Google Tài liệu diễn ra hoàn toàn trực tuyến. Bạn không bắt buộc phải đi lại trong chương trình này.

Làm cách nào để thông báo về Phần Google Tài liệu?

Truy cập danh sách gửi thư thông báo tại season-of-docs-announce để biết nội dung cập nhật và thông báo mới nhất liên quan đến Phần Tài liệu trên Google. Tham gia nhóm để nhận thông tin cập nhật qua email.

Tôi có thể thêm dòng thời gian của Phần Google Tài liệu vào lịch của mình không?

Sử dụng http://goo.gle/2NeZVew để đăng ký lịch Phần trên Google Tài liệu.

Tôi có thể làm gì để giúp quảng bá phần Google Tài liệu?

Bạn có thể tweet về chương trình, viết bài đăng trên blog, xuất bản video hoặc tổ chức một buổi gặp mặt hay buổi cung cấp thông tin trong khu vực của mình. Chúng tôi có một số nội dung và tài nguyên mẫu mà bạn có thể sử dụng để phân phối cho cộng đồng của mình (tổ chức, nhóm người viết và các đầu mối liên hệ khác).

Làm cách nào để tổ chức hoặc tổ chức phiên thông tin hoặc buổi gặp gỡ thông tin trong Phần Google Tài liệu?

Chúng tôi rất mong bạn có thể lên lịch gặp mặt vào bất kỳ thời gian và địa điểm nào thuận tiện cho bạn! Xem lại quy tắc chương trình và sử dụng nội dung mẫu.

Bạn có thể chia sẻ số liệu thống kê nào về các chương trình năm 2019 và 2020 không?

Có, bạn có thể xem kết quả của Phần trên Google Tài liệu cho chương trình năm 2019 trên Blog nguồn mở của Googlel (2019, 2020).

Tôi có nhận được áo thun Google Season of Tài liệu không?

Không, do hạn chế vận chuyển trên phạm vi quốc tế, Google Season of Tài liệu không còn có thể cung cấp áo phông cho những người tham gia hoàn thành thành công dự án Google Season of Tài liệu của họ.

Nếu bạn có câu hỏi khác?

Hãy xem hướng dẫn dành cho quản trị viên của tổ chức và hướng dẫn kỹ thuật cho người viết.

Nếu sau khi đọc hết tài liệu mà bạn vẫn không có câu trả lời, hãy xem xét thảo luận câu hỏi của bạn với cộng đồng Google Season of Tài liệu trong danh sách thảo luận. Hãy xem thông tin về các kênh thảo luận và cách liên hệ với chúng tôi.

Làm cách nào để trở thành người cố vấn cho Phần Google Tài liệu?

Phần Google Tài liệu không có vai trò cố vấn chính thức. Các tổ chức nên chỉ định cách người viết nội dung kỹ thuật tham gia và hỗ trợ cũng như cách xem xét và phê duyệt những đóng góp tài liệu của họ trong quá trình đăng ký của tổ chức. Nếu bạn muốn cố vấn cho người viết nội dung kỹ thuật trong Phần Google Tài liệu, hãy liên hệ với quản trị viên tổ chức của bạn để làm tình nguyện viên.

Phần Google Tài liệu có giống như Google Summer of Code không?

Không. Phần Google Tài liệu dành cho những người có kinh nghiệm viết kỹ thuật, không được thiết kế cho mục đích cố vấn như Google Mùa hè lập trình.

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

Khi nào người viết nội dung kỹ thuật có thể đăng ký Phần Google Tài liệu?

Phần Google Tài liệu không có đơn đăng ký ghi lại kỹ thuật chính thức. Để tham gia Phần Google Tài liệu với tư cách là người viết nội dung kỹ thuật, hãy liên hệ trực tiếp với các tổ chức nguồn mở bằng cách sử dụng hướng dẫn trên trang chương trình Phần Google Tài liệu của họ. Bạn cũng có thể bày tỏ sự quan tâm bằng cách thêm chính bạn vào Thư mục người viết kỹ thuật trong phần Google Tài liệu. Hãy xem hướng dẫn kỹ thuật dành cho người viết để biết thêm thông tin.

Tôi nên biết công cụ và khung tài liệu nào để tham gia Google Phần Tài liệu?

Các công cụ và khung tài liệu mà bạn sẽ sử dụng phụ thuộc vào tổ chức mà bạn muốn làm việc. Một phần mục tiêu của Google Season of Tài liệu là dành cho các dự án nguồn mở để giúp người viết nội dung kỹ thuật tìm hiểu thêm về các công cụ và khung liên quan đến việc ghi lại các sản phẩm nguồn mở. Do đó, thông thường, bạn không bắt buộc phải có kiến thức chi tiết về các nền tảng tài liệu cụ thể trước khi bắt đầu dự án Phần Google Tài liệu.

Tuy nhiên, hầu hết các tổ chức nguồn mở đều sử dụng một số phiên bản của Markdown hoặc ngôn ngữ đánh dấu khác cho tài liệu của họ. Bạn nên tìm hiểu ngôn ngữ mà tổ chức bạn chọn sử dụng và làm quen với cú pháp. Markdown là một khởi đầu tốt, vì các tệp README trên GitHub sử dụng một phiên bản của Markdown. Hãy xem hướng dẫn về GitHub cho Markdown.

Hãy tìm hiểu xem tổ chức bạn chọn đã lưu trữ tài liệu của họ trên một trang web hay chưa và liệu họ sử dụng nền tảng nào. Nền tảng này có thể là một trình tạo trang web tĩnh như Jekyll, Sphinx hoặc Hugo hoặc tổ chức có thể lưu trữ tài liệu của họ trên Read the Tài liệu hoặc GitHub Pages. Khi bạn đã tìm ra nền tảng mà tổ chức sử dụng, hãy khám phá và thử nghiệm bằng ngôn ngữ và khung có liên quan. Điều này giúp bạn nhanh chóng bắt đầu dự án nguồn mở và có được cơ hội tốt để đưa ra lời khuyên hợp lý cho dự án nguồn mở mà bạn chọn.

Tôi nên biết(các) ngôn ngữ lập trình nào để tham gia vào dự án Google Season of Tài liệu?

Tuỳ thuộc vào tính chất của dự án tài liệu, có thể bạn cần phải làm quen với một ngôn ngữ lập trình. Hãy lưu ý điều này khi chọn và đề xuất dự án tài liệu, đồng thời tham khảo ý kiến của tổ chức nguồn mở về mức độ quen thuộc cần thiết.

Những người viết kỹ thuật đã và đang thực hiện một dự án nguồn mở có thể tiếp tục viết dự án đó trong Phần Google Tài liệu không?

Có, nhưng tổ chức cần lưu ý về mối quan hệ trước đây hoặc đang diễn ra của người viết nội dung kỹ thuật với dự án trong đề xuất của họ.

Các yêu cầu để đủ điều kiện tham gia là gì?

Mình có cần phải có kinh nghiệm hoặc được đào tạo trước đó với tư cách là người viết nội dung kỹ thuật không?

Bạn nên có kinh nghiệm soạn thảo kỹ thuật hoặc được đào tạo từ trước nhưng không bắt buộc. Khi gửi tuyên bố mà bạn quan tâm cho một tổ chức, bạn có thể mô tả trải nghiệm của mình hoặc mọi chương trình đào tạo bạn đã tham gia bằng văn bản kỹ thuật. Bạn có thể cung cấp một số bằng chứng thể hiện mối quan tâm của mình đến tài liệu kỹ thuật hoặc tài liệu nguồn mở, bao gồm cả các ví dụ về tài liệu bạn đã viết. Tổ chức nguồn mở sẽ tìm kiếm những người viết nội dung kỹ thuật có mức độ kinh nghiệm mà tổ chức cần, để đảm bảo hoàn thành thành công dự án Phần Google Tài liệu của họ.

Tôi có được thanh toán khi tham gia Phần Google Tài liệu không?

Có. Google sẽ tài trợ cho các tổ chức được chấp nhận để thuê người viết nội dung kỹ thuật.

Thế nào là một lời tuyên bố quan tâm tốt về mặt kỹ thuật của tác giả?

Những tuyên bố đáng quan tâm nhất là của các tác giả kỹ thuật, những người dành thời gian tương tác và thảo luận về ý tưởng của họ với tổ chức nguồn mở mà họ đã chọn trước khi gửi tuyên bố. Xem hướng dẫn để tạo tuyên bố về mối quan tâm của bạn.

Mất bao lâu để tham gia Phần Google Tài liệu?

Quy mô dự án khác nhau, nhưng cam kết làm việc từ 5 đến 30 giờ mỗi tuần trong suốt chương trình. Tuy nhiên, khoảng thời gian bạn dành cho phụ thuộc vào tính chất của dự án mà bạn đã thoả thuận với tổ chức của mình. Trước khi cam kết, bạn nên đánh giá dự án và thảo luận về thời gian ước tính với tổ chức nguồn mở.

Với tư cách cá nhân, tôi có thể gửi đơn đăng ký tạo tài liệu cho dự án nguồn mở của tổ chức không? Tôi muốn tạo một loạt bài đăng trên blog, video hoặc các tài liệu khác về cách sử dụng công cụ hoặc dự án nguồn mở, nhưng tôi không tham gia hay đóng góp cho dự án này.

Không, bạn chỉ nên gửi đề xuất nếu có thể nhận tiền thay mặt cho dự án nguồn mở đó. Nếu bạn muốn tham gia trong một dự án, hãy liên hệ với dự án và cộng tác về một đề xuất ứng dụng.

Tôi là sinh viên, tôi có đủ điều kiện tham gia Phần Google Tài liệu không? Phần Tài liệu của Google có dạy tôi trở thành người viết nội dung kỹ thuật không?

Sinh viên có thể làm việc với các tổ chức được chấp nhận, nhưng Google Season of Tài liệu không nhằm mục đích dạy các kỹ năng viết kỹ thuật. Người viết kỹ thuật tham gia phải có kỹ năng viết kỹ thuật chuyên nghiệp hoặc kinh nghiệm liên quan tương đương. Khi đăng ký, những học viên muốn tham gia cần nêu bật được trải nghiệm viết và chỉnh sửa liên quan của họ.

Tôi có thể tham gia vừa là người viết nội dung kỹ thuật trong Phần Google Tài liệu vừa là sinh viên trong Chương trình Mùa hè lập trình của Google không?

Những cộng tác viên hoặc học viên mới được chấp nhận tham gia Mùa hè lập trình của Google không nên đăng ký làm người viết nội dung kỹ thuật trong Mùa Google Tài liệu.

Phần Google Tài liệu không dành cho người mới bắt đầu, mà dành cho những người đã có kinh nghiệm và kỹ năng viết kỹ thuật vững chắc. Người viết nội dung kỹ thuật trong Phần Tài liệu của Google không được cố vấn mà cần phải tự tổ chức và có động lực để vạch ra kế hoạch xử lý dự án của tổ chức mà không cần sự hướng dẫn của quản trị viên tổ chức và các thành viên khác trong cộng đồng.

Là người viết nội dung kỹ thuật, làm cách nào để liên hệ với quản trị viên chương trình Google Tài liệu mùa Google nếu tôi có thêm câu hỏi hoặc thắc mắc?

Bạn có thể liên hệ với quản trị viên chương trình Google Mùa Tài liệu của Google bằng cách gửi email cho họ theo địa chỉ season-of-docs@google.com.

Công ty hoặc đơn vị tư vấn viết kỹ thuật có thể tham gia Google Mùa Tài liệu không?

Có, một tổ chức có thể thuê một công ty để thực hiện công việc được nêu trong đề xuất của họ.

Làm cách nào để tham khảo phần Google Tài liệu trong sơ yếu lý lịch?

Liệt kê công việc này giống như cách bạn làm với mọi công việc tự do khác: "Làm việc với tư cách là người viết nội dung kỹ thuật cho [tên dự án] trong chương trình Phần Google Tài liệu".

Google có cung cấp chứng chỉ hoàn thành để tham gia Phần Tài liệu trên Google không?

Phần Google Tài liệu không thể gửi chứng chỉ hoặc xác nhận tham gia dự án cho người viết nội dung kỹ thuật.

Dành cho quản trị viên tổ chức nguồn mở

Các yêu cầu để hội đủ điều kiện đối với một tổ chức nguồn mở là gì?

Để đủ điều kiện tham gia với tư cách là một tổ chức, bạn phải là một nhóm đang chạy dự án phần mềm nguồn mở hoặc miễn phí đang hoạt động, chẳng hạn như BRL-CAD. Dự án không cần phải là một pháp nhân có tư cách pháp lý. Các tổ chức phải đã sản xuất và phát hành phần mềm theo giấy phép được phê duyệt của Sáng kiến nguồn mở và có ít nhất 2 người đóng góp làm quản trị viên tổ chức cho toàn bộ chương trình Phần Google Tài liệu để tham gia chương trình.

Ngoài ra, hãy tham khảo các yêu cầu được mô tả trong quy tắc chương trình và Chương trình trừng phạt và thông tin quốc gia của Bộ Tài chính Hoa Kỳ.

"Tổ chức" có tương đương với dự án nguồn mở không?

Một tổ chức có thể có một hoặc nhiều dự án nguồn mở. Một số tổ chức, chẳng hạn như các quỹ, có thể có nhiều tổ chức con, trong đó mỗi tổ chức có một hoặc nhiều dự án nguồn mở. Nếu tổ chức của bạn có các tổ chức con độc lập, hãy gửi các đơn đăng ký và đề xuất riêng cho từng tổ chức con.

Một tổ chức có thể gửi nhiều đơn đăng ký đề xuất không?

Không. Chỉ gửi một đơn đăng ký cho mỗi tổ chức. Nếu tổ chức của bạn có các tổ chức con (ví dụ: tổ chức của bạn là một tổ chức có nhiều dự án nguồn mở riêng lẻ), thì mỗi dự án phải gửi đơn đăng ký riêng, ngay cả khi quỹ tài trợ sẽ do tổ chức trung tâm xử lý.

Một nhóm dự án nguồn mở có thể gửi cùng một đề xuất để cùng xử lý một dự án tài liệu không?

Một tổ chức nên gửi đơn đăng ký đề xuất và chịu trách nhiệm điều phối công việc cũng như sự hỗ trợ của các dự án tham gia khác. (Ví dụ: một nhóm các dự án nguồn mở nhỏ, tất cả đều là trình bổ trợ cho một dự án lớn hơn và muốn cùng thực hiện hướng dẫn chung để tạo trình bổ trợ nên chọn một tổ chức dẫn dắt dự án.)

Tổ chức của tôi sẽ nhận được tiền bằng cách nào?

Để nhận được tiền, tổ chức của bạn phải có tài khoản Open Collective.

Tổ chức có nhận được tiền khi tham gia Phần tài liệu trên Google không?

Các tổ chức có thể sử dụng ngân sách cho hoạt động quản trị, cố vấn hoặc đánh giá công việc trong ngân sách dự án.

Google có trả phí xử lý thanh toán không?

Google không chi trả phí xử lý thanh toán, vì các khoản phí này có xu hướng khác nhau tuỳ thuộc vào phương thức thanh toán. Tuy nhiên, Google sẽ trả phí cho nền tảng Open Collective và nếu bạn quyết định sử dụng Open Collective làm máy chủ tài chính thì bạn cũng sẽ chịu phí. Xem Hướng dẫn nhận tài trợ để biết thêm thông tin.

Tổ chức của tôi nên lập ngân sách cho chi phí cho một người viết nội dung kỹ thuật như thế nào?

Bạn nên xem bài viết Viết bản khảo sát về mức lương trên Tài liệu và tính các mức giá theo giờ. Bạn cũng có thể tham gia chương trình Write The Slack Slack và đặt câu hỏi trong kênh #season-of-docs cho các tác giả quan tâm về kỹ thuật đặt giá thầu.

Tổ chức của tôi có thể sử dụng khoản tiền tài trợ cho Phần Google Tài liệu để thanh toán cho một người đóng góp hiện tại không?

Có. Tuy nhiên, đề xuất dự án phải dành cho công việc mới (bao gồm cả công việc bảo trì, sửa đổi hoặc nâng cấp lên tài liệu hiện có). Bạn không thể xin cấp quyền dùng để thanh toán cho các bài tập đã hoàn thành.

Tổ chức của tôi có thể làm việc với những học viên viết nội dung kỹ thuật không?

Bạn có thể chọn để học viên viết nội dung kỹ thuật cho dự án của mình. Nếu chọn hợp tác với học viên, bạn nên chỉ tham gia ở những học viên:

  • Trên 18 tuổi
  • Đã đăng ký tham gia một chương trình hoặc khoá học viết kỹ thuật hoặc truyền thông kỹ thuật
  • Có quyền tiếp cận rõ ràng với cố vấn viết nội dung kỹ thuật thông qua chương trình hoặc khoá học của họ

Tổ chức của tôi có thể làm việc với nhiều kỹ thuật viên không?

Tổ chức của bạn có thể chọn và trả nhiều hơn một người viết nội dung kỹ thuật, nhưng tất cả người viết nội dung kỹ thuật làm việc với tổ chức của bạn đều phải thực hiện dự án mà bạn đề xuất. Việc làm việc với nhiều người viết kỹ thuật sẽ khiến dự án của bạn trở nên phức tạp hơn và đòi hỏi nhiều thời gian tình nguyện và quản trị hơn.

Tổ chức của tôi có thể thuê một công ty viết kỹ thuật để thực hiện dự án này không?

Có, tổ chức của bạn có thể thuê một công ty viết kỹ thuật để thực hiện dự án của bạn. Hãy đảm bảo rằng công ty mà bạn thuê có thể được thanh toán qua Open Collective.

Người viết nội dung kỹ thuật của chúng tôi đã bỏ ngang trước khi kết thúc chương trình. Tổ chức của chúng tôi có đủ điều kiện nhận số tiền còn lại không?

Các dự án nên cố gắng tìm một người viết nội dung kỹ thuật mới để hoàn thành dự án của mình trước khi kết thúc chương trình. Tuy nhiên, việc giải ngân số tiền còn lại không dựa trên việc hoàn thành dự án, mà dựa trên việc hoàn thành nghiên cứu điển hình và đánh giá cuối cùng.

Nếu dự án của bạn không thể hoàn tất, bạn nên tìm hiểu lý do. Ví dụ: có thể bạn đã nhận thấy rằng bộ công cụ lập tài liệu của mình rất phức tạp và là một rào cản khi làm quen với người viết kỹ thuật, hoặc dự án của bạn liên quan đến việc kiểm thử và cập nhật tài liệu hướng dẫn, đồng thời đòi hỏi nhiều kinh nghiệm lập trình. Dựa trên kinh nghiệm của mình, bạn có đề xuất gì cho các dự án khác không? Hãy đưa thông tin đó vào nghiên cứu điển hình của bạn.

Đơn đăng ký của tổ chức có được xem xét trước thời hạn gửi không?

Rất tiếc, Phần Google Tài liệu không thể cung cấp phản hồi về ứng dụng của tổ chức.

Các tổ chức nên xác định phạm vi đề xuất dự án của mình như thế nào?

Khi phát triển ý tưởng cho dự án, hãy cố gắng tìm các dự án nhỏ nhất sẽ mang lại giá trị cho tổ chức (nhưng có thể mở rộng nếu thời gian cho phép). Càng nhỏ càng tốt. Khi tạo đề xuất dự án, bạn nên chọn các dự án nhỏ, chi tiết hơn thay vì các dự án lớn hơn, ít được chỉ định hơn. Nếu dự án của bạn đòi hỏi nhiều kiến thức chuyên môn về miền, hãy cố gắng đưa vào các dự án mà người không có kiến thức nền tảng đó có thể thực hiện.

Tôi có thể tham gia với tư cách quản trị viên tổ chức trong Phần Google Tài liệu và cố vấn trong Mùa hè lập trình của Google không?

Có. Phần Google Tài liệu và Mùa hè lập trình của Google là các chương trình riêng biệt. Nếu bạn có băng thông để tham gia cả hai chương trình thì không sao.

Tổ chức của chúng tôi đã tham gia các chương trình cho Mùa Google Tài liệu trước đây. Tổ chức của chúng tôi có thể đăng ký lại không?

Có, những tổ chức từng tham gia chương trình Mùa Google Tài liệu trước đây đủ điều kiện đăng ký lại.

Dữ liệu đã lưu trữ

Làm cách nào để xóa thông tin của tôi khỏi kho lưu trữ Phần tài liệu của Google?

Liên hệ với chúng tôi để xoá thông tin của bạn.