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

Giai đoạn hiện tại:
Hoàn thiện dự án. Xem tiến trình.

Giải pháp chung

Season of Docs 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 tuyển dụng của Google.

Tổ chức của chúng tôi muốn tham gia Google Season of Docs nhưng không biết nên bắt đầu từ đâu

Hãy xem danh sách đầy đủ ý tưởng dự án của chúng tôi! Bạn cũng có thể liên hệ với cộng đồng viết tài liệu kỹ thuật (hãy thử kênh #season-of-docs trong Write the Docs Slack hoặc trên các kênh mạng xã hội của bạn để 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 một trang web tài liệu trên nền tảng do người viết kỹ thuật và tổ chức nguồn mở quyết định, đồng thời xuất bản một 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ở để mang lại trải nghiệm người dùng tốt hơn hoặc cấu trúc thông tin dễ tiếp cận hơn.

  • Viết nội dung tổng quan hoặc giới thiệu về khái niệm của 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, dẫn đến việc có rất nhiều thông tin chi tiết nhưng khó hiểu được 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 một trường hợp sử dụng nổi bật.

  • Tạo một bộ hướng dẫn tập trung về cách thực hiện các nhiệm vụ cụ thể.

  • Tạo hướng dẫn dành cho cộng tác viên, trong đó có thông tin cơ bản về cách bắt đầu đó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 và xem xét, xây dựng dự án, v.v.

Video có thể là dự án cho Google Season of Docs không?

Có. Hãy đảm bảo rằng bạn đã xác định đúng phạm vi yêu cầu đối với video và lưu ý rằng việc sản xuất video chất lượng cao sẽ tốn nhiều thời gian và tài nguyên.

Việc kiểm tra tài liệu có phải là dự án hợp lý cho Google Season of Docs không?

Kiểm tra tài liệu là một dự án tuyệt vời cho Google Season of Docs. 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, bạn nên tạo tài liệu bị thiếu có mức độ ưu tiên cao nhất trong dự án của mình.

Có mẫu tài liệu nào dành cho các tổ chức và nhà văn kỹ thuật để sử dụng không?

Google Season of Docs 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 kiểm tra tài liệu. Các mẫu khác sẽ được thêm khi được tạo.

Dự án Tài liệu chất lượng đang nỗ lực tạo một số mẫu tài liệu tối thiểu có thể sử dụng cho mã 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 kỹ thuật tạo không?

Không. Đôi khi, dự án không diễn ra như mong đợi hoặ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 các tài liệu khác được tạo ra, nhưng chúng tôi mong rằng bản đá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.

Google Season of Docs diễn ra ở đâu?

Google Season of Docs diễn ra hoàn toàn trên mạng. Bạn không cần phải di chuyển trong quá trình tham gia chương trình.

Làm cách nào để nhận thông tin mới nhất về Google Season of Docs?

Truy cập danh sách gửi thư thông báo tại season-of-docs-announce để biết thông tin cập nhật và thông báo mới nhất liên quan đến Google Season of Docs. Hãy tham gia nhóm này để nhận thông tin cập nhật qua email.

Tôi có thể thêm tiến trình của Google Season of Docs vào lịch của mình không?

Truy cập vào http://goo.gle/2NeZVew để đăng ký nhận lịch của Google Season of Docs.

Tôi có thể làm gì để giúp lan truyền thông tin về Google Season of Docs?

Bạn có thể đăng 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 họp mặt hoặc buổi cung cấp thông tin ở 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 nhà văn và các mối quan hệ khác).

Làm cách nào để tổ chức hoặc tổ chức một buổi họp mặt hoặc phiên thông tin về Google Season of Docs?

Bạn có thể lên lịch gặp mặt vào thời gian và địa điểm thuận tiện cho mình! Xem lại quy tắc của 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 chương trình Google Season of Docs năm 2019 trên Bài đăng trên blog về nguồn mở của Google (2019, 2020).

Tôi có nhận được áo phông Google Season of Docs không?

Không, do các quy định hạn chế về việc vận chuyển quốc tế, Google Season of Docs không 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 Docs.

Nếu tôi có câu hỏi khác thì sao?

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

Nếu sau khi đọc hết tài liệu mà bạn vẫn không tìm được câu trả lời, hãy cân nhắc thảo luận các câu hỏi của bạn với cộng đồng Google Season of Docs trên danh sách thảo luận. Xem thông tin về 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 Google Season of Docs?

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

Google Season of Docs có giống Google Summer of Code không?

Không. Google Season of Docs dành cho những người có một số kinh nghiệm viết kỹ thuật, chứ không phải là một chương trình cố vấn như Google Summer of Code.

Dành cho người viết tài liệu kỹ thuật

Khi nào người viết nội dung kỹ thuật có thể đăng ký tham gia Google Season of Docs?

Google Season of Docs không có đơn đăng ký chính thức dành cho nhà văn kỹ thuật. Để tham gia Google Season of Docs với vai trò là một nhà văn kỹ thuật, 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. Bạn cũng có thể bày tỏ sự quan tâm bằng cách thêm mình vào Danh bạ nhà văn kỹ thuật của Google Season of Docs. Hãy xem hướng dẫn dành cho nhà văn kỹ thuật để biết thêm thông tin.

Tôi cần biết những công cụ và khung tài liệu nào để tham gia Google Season of Docs?

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 hợp tác. Một phần mục tiêu của Google Season of Docs là giúp các dự án nguồn mở hỗ trợ các nhà văn kỹ thuật tìm hiểu thêm về các công cụ và khung liên quan đến việc ghi chép các sản phẩm nguồn mở. Vì lý do đó, bạn thường không cần 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 Google Season of Docs.

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 Markdown hoặc một ngôn ngữ đánh dấu khác cho tài liệu của họ. Bạn nên tìm hiểu xem tổ chức mà bạn chọn sử dụng ngôn ngữ nào và làm quen với cú pháp. Markdown là một lựa chọn phù hợp để bắt đầu, vì các tệp README trên GitHub sử dụng một phiên bản Markdown. Xem hướng dẫn của GitHub về Markdown.

Tìm hiểu xem tổ chức mà bạn chọn có lưu trữ tài liệu trên trang web hay không và nếu có thì 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 Docs hoặc GitHub Pages. Khi bạn đã tìm hiểu được nền tảng mà tổ chức sử dụng, hãy khám phá và thử nghiệm với ngôn ngữ và khung phù hợp. Điều này giúp bạn nhanh chóng bắt đầu dự án nguồn mở và giúp bạn có thể đưa ra lời khuyên hữu ích cho dự án nguồn mở mà bạn chọn.

Tôi cần biết(những) ngôn ngữ lập trình nào để tham gia các dự án trong Google Season of Docs?

Tuỳ thuộc vào bản chất của dự án tài liệu, bạn có thể cần phải quen thuộc 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 mộ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 nội dung kỹ thuật đang làm việc trên một dự án nguồn mở có thể tiếp tục làm việc trên dự án đó trong chương trình Google Season of Docs không?

Có, nhưng tổ chức nên ghi chú mối quan hệ trước đây hoặc hiện tại của người viết kỹ thuật với dự án trong đề xuất của họ.

Những ai đủ điều kiện tham gia?

Tôi có cần kinh nghiệm hoặc được đào tạo trước khi làm nhà văn kỹ thuật không?

Ưu tiên những người có kinh nghiệm hoặc được đào tạo về cách viết tài liệu kỹ thuật, nhưng không bắt buộc. Khi gửi tuyên bố quan tâm đến một tổ chức, bạn có thể mô tả kinh nghiệm hoặc bất kỳ khóa đào tạo nào bạn đã tham gia về kỹ năng viết tài liệu kỹ thuật. Bạn phải cung cấp một số bằng chứng cho thấy bạn quan tâm đến tài liệu kỹ thuật hoặc tài liệu nguồn mở, bao gồm cả ví dụ về tài liệu bạn đã viết. Tổ chức nguồn mở này sẽ tìm kiếm những người viết 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 các dự án Google Season of Docs.

Tôi có được trả tiền khi tham gia Google Season of Docs không?

Có. Google sẽ cấp tài trợ cho các tổ chức được chấp nhận để sử dụng nhằm tuyển dụng nhà văn kỹ thuật.

Câu tuyên bố về mối quan tâm của một nhà văn kỹ thuật giỏi sẽ như thế nào?

Những tuyên bố quan tâm tốt nhất là của các nhà văn kỹ thuật dành thời gian tương tác và thảo luận ý 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ố. Hãy xem hướng dẫn tạo bản tuyên bố về mối quan tâm.

Thời gian tham gia Google Season of Docs là bao lâu?

Quy mô dự án khác nhau, nhưng dao động từ cam kết 5 đến 30 giờ mỗi tuần trong chương trình. Tuy nhiên, thời gian bạn dành ra sẽ phụ thuộc vào bản 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ở.

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

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

Tôi là sinh viên, tôi có đủ điều kiện tham gia Google Season of Docs không? Google Season of Docs có giúp tôi trở thành một người viết nội dung kỹ thuật không?

Học viên đủ điều kiện làm việc với các tổ chức được chấp nhận, nhưng Google Season of Docs không nhằm mục đích dạy kỹ năng viết tài liệu kỹ thuật. Người viết nội dung kỹ thuật tham gia chương trình này phải có kỹ năng viết nội dung kỹ thuật chuyên nghiệp hoặc có kinh nghiệm tương đương liên quan. Những học viên muốn tham gia phải nhớ nhấn mạnh kinh nghiệm viết và biên tập có liên quan của mình khi đăng ký.

Tôi có thể tham gia với tư cách là cả một nhà văn kỹ thuật trong Google Season of Docs và một học viên trong Google Summer of Code không?

Những người đóng góp mới hoặc sinh viên được chấp nhận tham gia Google Summer of Code không nên đăng ký làm nhà văn kỹ thuật của Google Season of Docs.

Google Season of Docs không dành cho người mới bắt đầu, mà dành cho những người đã có kỹ năng và kinh nghiệm viết kỹ thuật vững vàng. Các nhà văn kỹ thuật trong Google Season of Docs không được cố vấn, mà thay vào đó, họ cần tự tổ chức và tự động viên để tìm ra kế hoạch giải quyết dự án của tổ chức với ít hướng dẫn từ quản trị viên tổ chức và các thành viên khác trong cộng đồng.

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

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

Công ty viết tài liệu kỹ thuật hoặc công ty tư vấn có thể tham gia Google Season of Docs 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 Google Season of Docs trên sơ yếu lý lịch của tôi?

Hãy liệt kê công việc này như mọi công việc tự do khác: "Làm nhà văn kỹ thuật cho [tên dự án] trong chương trình Google Season of Docs".

Google có cung cấp chứng chỉ hoàn thành cho những người tham gia Chương trình Google về Tài liệu không?

Google Season of Docs không thể gửi giấy chứng nhận hoặc thư xác nhận tham gia dự án cho các nhà văn kỹ thuật.

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

Tổ chức nguồn mở cần đáp ứng những yêu cầu nào?

Để đủ đ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 điều hành một 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 hợp nhất hợp pháp. Để tham gia chương trình, 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 hai cộng tác viên làm quản trị viên tổ chức trong toàn bộ chương trình Google Season of Docs.

Ngoài ra, hãy tham khảo các yêu cầu về điều kiện tham gia được mô tả trong quy tắc của chương trình và Chương trình trừng phạt và Thông tin về 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 tổ chức từ thiện, có thể có nhiều tổ chức phụ, mỗi tổ chức phụ 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 phụ độc lập, hãy gửi đơn đăng ký và đề xuất riêng cho từng tổ chức phụ.

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

Không. Mỗi tổ chức chỉ được gửi một đơn đăng ký. Nếu tổ chức của bạn có các tổ chức phụ (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 tổ chức mẹ sẽ xử lý các khoản tài trợ.

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

Một tổ chức sẽ 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ư hỗ trợ từ các dự án tham gia khác. (Ví dụ: một nhóm dự án nguồn mở nhỏ, tất cả đều là trình bổ trợ cho một dự án lớn hơn, muốn làm việc trên một hướng dẫn chung về cách 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 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.

Các tổ chức có nhận được tiền khi tham gia Google Season of Docs không?

Các tổ chức có thể đưa khoản tiền dành cho hoạt động quản lý, cố vấn hoặc xem xét công việc vào ngân sách dự án của họ.

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

Google không chịu phí xử lý thanh toán vì các khoản phí này thường khác nhau tuỳ theo phương thức thanh toán. Tuy nhiên, Google sẽ trả phí nền tảng Open Collective. Nếu bạn quyết định sử dụng Open Collective làm đơn vị lưu trữ tài chính, thì phí này cũng sẽ được trả. Hãy 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í của một nhà văn kỹ thuật như thế nào?

Bạn nên xem bản khảo sát về mức lương của Write the Docs và tính mức giá theo giờ. Bạn cũng có thể tham gia Write The Docs Slack và yêu cầu trong kênh #season-of-docs để các nhà văn kỹ thuật quan tâm đặt giá thầu.

Tổ chức của tôi có thể sử dụng khoản tài trợ của Google Season of Docs để trả tiền cho một cộng tác viên 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 tài liệu hiện có). Bạn không được đăng ký nhận tài trợ để thanh toán cho công việc đã hoàn thành.

Tổ chức của tôi có thể hợp tác với các học viên viết nội dung kỹ thuật không?

Bạn có thể chọn để các học viên viết kỹ thuật làm việc trên dự án của bạn. Nếu chọn làm việc với học viên, bạn nên giới hạn việc tham gia cho những học viên:

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

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

Tổ chức của bạn có thể chọn và trả phí cho nhiều 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 làm việc trên dự án mà bạn đề xuất. Việc làm việc với nhiều người viết nội dung kỹ thuật sẽ làm phức tạp thêm dự án của bạn, đồng thời đòi hỏi nhiều thời gian hơn cho việc quản lý và huy động tình nguyện viên.

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

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

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

Các dự án nên tìm một người viết nội dung kỹ thuật mới để hoàn thành dự án 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 bạn không thể hoàn thành dự án, nghiên cứu điển hình của bạn phải xem xét lý do. Ví dụ: bạn có thể nhận thấy rằng công cụ tạo tài liệu của mình rất phức tạp và gây trở ngại cho việc làm quen với một nhà văn 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 hướng dẫn, đồng thời yêu cầu kinh nghiệm lập trình chuyên sâu. 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.

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

Rất tiếc, Google Season of Docs không thể đưa ra ý kiến phản hồi về đơn đăng ký của tổ chức.

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

Khi phát triển ý tưởng dự án, hãy cố gắng tìm những dự án nhỏ nhất có thể mang lại giá trị cho tổ chức (nhưng có thể mở rộng nếu có thời gian). Kích thước 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ỏ hơn, chi tiết hơn thay vì các dự án lớn hơn nhưng ít được chỉ định. Nếu dự án của bạn đòi hỏi nhiều kiến thức chuyên môn về lĩnh vực, hãy cố gắng đưa vào các dự án mà một người không có kiến thức chuyên môn đó cũng có thể làm được.

Tôi có thể tham gia với tư cách là quản trị viên tổ chức trong Google Season of Docs và làm cố vấn trong Google Summer of Code không?

Có. Google Season of Docs và Google Summer of Code là hai 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ì bạn có thể làm như vậy.

Tổ chức của chúng tôi đã tham gia các chương trình Google Season of Docs 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 đã tham gia các chương trình Google Season of Docs trước đây đều đủ điều kiện đăng ký lại.

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

Làm cách nào để xoá thông tin của tôi khỏi kho lưu trữ Google Season of Docs?

Hãy liên hệ với chúng tôi để yêu cầu xoá thông tin của bạn.