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

Giai đoạn hiện tại:
Chương trình Phần Tài liệu năm 2019 đã kết thúc vào ngày 6 tháng 3 năm 2020. Hãy xem dòng thời gian.

Giải pháp chung

Phần Tài liệu 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, vui lòng truy cập vào trang web việc làm của Google.

Mùa Tài liệu có được coi là một thực tập sinh, một công việc hoặc bất kỳ hình thức công việc nào không?

Không. Phần Tài liệu là một hoạt động mà người viết nội dung kỹ thuật thực hiện với tư cách là người viết nội dung kỹ thuật độc lập và họ sẽ được trả một khoản phụ trợ. Người viết nội dung kỹ thuật có thể chọn từ chối nhận trợ cấp.

Tại sao tôi nên tham gia Phần Tài liệu?

Mục tiêu của Season of Tài liệu là thúc đẩy sự cộng tác giữa các tổ chức nguồn mở và người viết kỹ thuật. Chúng tôi nghĩ rằng chương trình này sẽ:

  • Tạo cơ hội cho người viết nội dung kỹ thuật có được kinh nghiệm đóng góp cho các dự án nguồn mở và tìm hiểu về mã nguồn mở.
  • Mang đến cho các dự án nguồn mở cơ hội tương tác với cộng đồng viết kỹ thuật, từ đó cải thiện tài liệu nguồn mở của họ.
  • Nâng cao nhận thức về tài liệu nguồn mở và tài liệu kỹ thuật.

Lợi ích dành cho tổ chức nguồn mở:

  • Có kinh nghiệm làm việc với một nhà viết nội dung kỹ thuật.
  • Tài liệu cải tiến.
  • Tiềm năng cộng tác liên tục với các tác giả kỹ thuật sau khi Mùa tài liệu kết thúc.
  • Cải tiến các quy trình tạo tài liệu cho dự án của bạn.
  • Nâng cao nhận thức về tài liệu nguồn mở trong cộng đồng viết kỹ thuật.

Lợi ích dành cho người viết nội dung kỹ thuật:

  • Có kinh nghiệm đóng góp cho dự án nguồn mở.
  • Có kinh nghiệm làm việc với các tài liệu tập trung vào nhà phát triển và với mã.
  • Ghi nhận và ghi nhận công sức hoàn thành.
  • Nội dung cần thêm vào sơ yếu lý lịch của bạn.
  • Tiềm năng cộng tác liên tục với dự án nguồn mở sau khi Phần Tài liệu kết thúc
  • Nâng cao nhận thức trong các cộng đồng nguồn mở về giá trị mà các nhà văn kỹ thuật có thể mang lại.

Người viết nội dung kỹ thuật có thể xử lý 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 một nền tảng do người viết kỹ thuật và cố vấn 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ở để 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 phần giới thiệu tổng quan 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à tài liệu có rất nhiều thông tin chi tiết nhưng lại 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 trường hợp sử dụng phổ biến.

  • Tạo một bộ hướng dẫn tập trung vào từng 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à cộng tác viên 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 lấy yêu cầu và bài đánh giá, cách xây dựng dự án, v.v.

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

Có. Tổ chức nguồn mở có quyền quyết định việc xuất bản ý tưởng dự án và chọn đề xuất dự án do người viết nội dung kỹ thuật gửi đi. Nếu một video đáp ứng các yêu cầu của tổ chức nguồn mở, thì bạn có thể gửi video đó dưới dạng dự án Season of Tài liệu, miễn đó là video hướng dẫn kỹ thuật. Hãy đảm bảo các yêu cầu đối với video có phạm vi rõ ràng và lưu ý rằng việc sản xuất một video chất lượng cao cần rất nhiều thời gian và nguồn lực.

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

Không. Mặc dù chúng tôi hy vọng rằng tất cả tài liệu và mã nguồn trong chương trình này sẽ mang lại sự hài lòng, nhưng chúng tôi không yêu cầu các tổ chức phải sử dụng tài liệu hoặc mã của người viết về kỹ thuật.

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

Phần Tài liệu hoàn toàn xuất hiện trực tuyến. Bạn không cần phải đi lại để tham gia chương trình này.

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

Hãy truy cập vào 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 Phần của Tài liệu. Hãy tham gia nhóm để nhận thông tin cập nhật qua email.

Tôi có thể làm gì để quảng bá Phần 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ể dùng để phân phối tới cộng đồng của mình (tổ chức, nhóm người viết và những người liên hệ khác).

Làm cách nào để tổ chức hoặc tổ chức buổi gặp gỡ hoặc buổi chia sẻ thông tin về Phần Tài liệu?

Bạn có thể lên lịch tổ chức một buổi gặp mặt bất kỳ lúc nào và tại bất kỳ địa điểm nào thuận tiện cho bạn! Vui lòng xem lại quy tắc chương trình và sử dụng nội dung mẫu.

Tôi có thể tham gia Phần Tài liệu với tư cách là người cố vấn và người viết kỹ thuật không?

Không. Chúng tôi muốn đảm bảo rằng mỗi dự án và người viết nội dung kỹ thuật đều được quan tâm đúng mức và chúng tôi cho rằng điều này có thể tạo ra trải nghiệm không tốt cho những người liên quan. Vui lòng chọn xem việc tham gia với tư cách là người cố vấn hoặc người viết nội dung kỹ thuật có hấp dẫn hơn đối với bạn hay không và có kế hoạch đăng ký phù hợp.

Tôi có nhận được áo phông cho phần Tài liệu không?

Có chứ! Những người tham gia dự án đã hoàn tất thành công sẽ nhận được một áo thun Tài liệu. Áo phông của năm nay sẽ là áo phông ra mắt trong chương trình.

Khi nào áo phông của tôi sẽ đến nơi?

Do tình hình dịch COVID-19, chúng tôi hiện không thể dự đoán thời điểm bạn sẽ nhận được áo phông. Google đã thuê một nhà cung cấp sản xuất áo phông và xử lý công việc hậu cần vận chuyển áo vòng quanh thế giới. Quản trị viên chương trình của Google sẽ gửi cho bạn một mã truy cập duy nhất qua email để chọn kiểu/kích thước áo phông và nhập thông tin giao hàng khi có thể sản xuất. Quá trình sản xuất và vận chuyển áo phông thường mất vài tuần.

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

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

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 cân nhắc việc thảo luận câu hỏi của bạn với cộng đồng Phần tài liệu trên Slack hoặc danh sách thảo luận. 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.

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 Tài liệu?

Giai đoạn đăng ký của nhà văn kỹ thuật bắt đầu từ ngày 29 tháng 5 năm 2019 đến ngày 28 tháng 6 năm 2019. Xem tiến trình chương trìnhhướng dẫn dành cho người viết kỹ thuật.

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

Các công cụ và khung tài liệu mà bạn sẽ sử dụng tuỳ thuộc vào tổ chức mà bạn muốn hợp tác. Mục tiêu của Season of Tài liệu là nhằm giúp 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 tạo tài liệu cho sản phẩm nguồn mở. Vì lý 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 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 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 ngôn ngữ mà tổ chức của 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 Markdown. Xem hướng dẫn về Markdown trên GitHub.

Hãy tìm hiểu xem tổ chức mà bạn chọn đã lưu trữ tài liệu của họ trên trang web hay chưa và 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ũng 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 đã biết tổ chức nền tảng nào sử dụng, hãy khám phá và thử nghiệm với ngôn ngữ và khung liên quan. Điều này giúp bạn nhanh chóng bắt đầu với dự án nguồn mở và đưa bạn đến một nơi phù hợp để đưa ra lời khuyên phù hợp 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 Phần 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 sẽ cần phải thành thạo 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, cũng như tham khảo ý kiến của tổ chức nguồn mở về mức độ quen thuộc cần thiết.

Tôi có thể gửi nhiều bản đề xuất dự án không?

Có, nhưng chúng tôi chỉ chấp nhận một bản đề xuất dự án cho mỗi người viết kỹ thuật. Xem hướng dẫn để tạo ứng dụng.

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

Có, nhưng bạn nên lưu ý mối quan hệ trước đó với dự án trong đề xuất.

Một nhóm có thể cùng gửi đề xuất để cùng làm việc trong một dự án không?

Không, chỉ cá nhân mới có thể làm việc trong một dự án nhất định.

Tôi có thể liên hệ trực tiếp với các tổ chức cố vấn trước khi gửi đề xuất cho Phần Tài liệu không?

Có, bạn có thể trao đổi trực tiếp với tổ chức nguồn mở mà bạn muốn hợp tác trước khi gửi đơn đăng ký cho phần Tài liệu. Các cố vấn nguồn mở có thể giúp bạn tinh chỉnh ý tưởng dự án của mình.

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

Google có trường hợp ngoại lệ cho các điều kiện để tôi tham gia không?

Không. Chúng tôi không thể chấp nhận trường hợp ngoại lệ nếu bạn không đáp ứng các yêu cầu, bất kể bạn có tài năng hay quan tâm hay không. Việc áp dụng ngoại lệ cho bạn sẽ không công bằng với những người viết nội dung kỹ thuật khác đăng ký tham gia Season of Tài liệu.

Tôi cần cung cấp những biểu mẫu nào?

Những người tham gia được chấp nhận cần cung cấp các biểu mẫu thuế phù hợp.

Tôi có cần kinh nghiệm trước đó hoặc cần được đào tạo để trở thành người viết kỹ thuật không?

Bạn nên có kinh nghiệm viết hoặc đào tạo về kỹ thuật trước đó nhưng không cần thiết. Khi gửi đề xuất dự án, bạn có thể mô tả trải nghiệm và/hoặc chương trình đào tạo của mình bằng văn bản kỹ thuật. Bạn có thể 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ả các ví dụ về tài liệu bạn đã viết. Chương trình Phần tài liệu hướng đến việc hợp tác với các nhà văn kỹ thuật có kinh nghiệm hoặc đang đào tạo với các cố vấn nguồn mở để mỗi người có thể học hỏi từ nhau. 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 các dự án trong Phần Tài liệu của họ.

Tôi có được trả tiền để tham gia Phần Tài liệu không?

Có. Google sẽ trợ cấp tiền thưởng cho những người viết nội dung kỹ thuật hoàn thành chương trình thành công. Bạn có thể chọn không nhận khoản trợ cấp này. Xem thông tin chi tiết về phụ lục cho người viết kỹ thuật.

Tôi có được thanh toán ngay cả khi tổ chức không sử dụng giấy tờ hoặc mã của tôi không?

Có, miễn là dự án của bạn vượt qua bài đánh giá cuối cùng của người cố vấn nguồn mở. Việc dự án nguồn mở có sử dụng tài liệu hoặc mã được sản xuất hay không đều không ảnh hưởng đến việc thanh toán phụ cấp cho người viết kỹ thuật.

Một bản đề xuất kỹ thuật của người viết có ý nghĩa như thế nào?

Đề xuất hay nhất là của các tác giả kỹ thuật, dành thời gian tương tác và thảo luận ý tưởng với tổ chức nguồn mở mà họ đã chọn trước khi gửi đơn đăng ký Phần Tài liệu. Xem hướng dẫn để tạo ứng dụng.

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

Khoảng thời gian dành cho tổ chức cố vấn sẽ 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ố vấn. Yêu cầu về số giờ là có chủ ý linh hoạt, để cho phép nhiều loại dự án và phong cách làm việc khác nhau.

Trước khi gửi đề xuất dự án, 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ở. Nếu khó dành thời gian đã thoả thuận do các cam kết khác, bạn có một lựa chọn để hoàn thành dự án trong thời gian dài hơn mà vẫn nhận được tiền lương và ghi nhận công việc đã hoàn thành. Khi bạn gửi phần ứng dụng Tài liệu, hãy chỉ định tuỳ chọn dành cho một dự án chạy trong thời gian dài.

Tôi đang học giao tiếp kỹ thuật nhưng chưa có kinh nghiệm làm việc. Tôi vẫn có thể tham gia chứ?

Có. Khi gửi bản đề xuất dự án, hãy liệt kê các khoá học đại học hoặc cao đẳng của bạn trong phần này về kinh nghiệm làm việc trước đây.

Tôi là sinh viên được chấp nhận tại Hoa Kỳ theo thị thực F1. Làm cách nào để được uỷ quyền tham gia?

Vui lòng trao đổi với phòng phụ trách vấn đề về sinh viên quốc tế của trường bạn để biết thêm chi tiết. Google không thể cung cấp cho bạn bất kỳ loại hình uỷ quyền CPT hoặc OPT nào.

Tất cả những người tham gia được chấp nhận sẽ nhận được email xác nhận chấp nhận tham gia. Chúng tôi không cung cấp chữ cái tuỳ chỉnh.

Phần Tài liệu sử dụng thông tin từ biểu mẫu đăng ký của tôi như thế nào?

Quản trị viên chương trình của Google sẽ chuyển một số thông tin từ ứng dụng của bạn đến quản trị viên của tổ chức nguồn mở mà bạn đã chọn để tổ chức có thể đánh giá đề xuất dự án của bạn.

Nếu dự án của bạn được chấp nhận tham gia chương trình, Phần Tài liệu sẽ xuất bản thông tin chi tiết về dự án trên trang web.

Xem nội dung mô tả về việc sử dụng dữ liệu trong hướng dẫn về biểu mẫu đăng ký dành cho nhà viết kỹ thuật.

Dành cho người cố vấn nguồn mở và quản trị viên tổ chức

Tôi muốn tìm hiểu thêm về cách tham gia cố vấn về Phần Tài liệu. Tôi có thể tìm thêm thông tin ở đâu?

Đọc hướng dẫn dành cho người cố vấnquy tắc chương trình để biết thêm thông tin về cách trở thành người cố vấn Mùa tài liệu.

Các yêu cầu để tham gia một tổ chức cố vấn là gì?

Để đủ điều kiện tham gia với tư cách là tổ chức cố vấn, bạn phải là một nhóm đang chạy dự án phần mềm miễn phí/nguồn mở đang hoạt động, chẳng hạn như BRL-CAD. Dự án không nhất thiết phải là một pháp nhân có tư cách pháp nhân. Các tổ chức cố vấn 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 và/hoặc người cố vấn cho toàn bộ chương trình Phần Tài liệu để tham gia chương trình.

Hãy tham khảo thêm các yêu cầu được mô tả trong quy tắc chương trìnhChương trình cấm vận và thông tin quốc gia của Kho bạc Hoa Kỳ.

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

Các tổ chức có trạng thái tốt sẽ nhận được khoản tiền trợ cấp cho mỗi người viết nội dung kỹ thuật được chấp nhận khi kết thúc chương trình. Điều này bất kể dự án của người viết kỹ thuật có thành công hay không. Các tổ chức có thể sử dụng các khoản tiền này tuỳ thích.

Quản trị viên chương trình của Google phân bổ vị trí cho các dự án viết kỹ thuật bằng cách nào?

Chương trình thí điểm Season of Tài liệu năm 2019 chỉ giới hạn ở tối đa 50 dự án viết kỹ thuật.

Theo nguyên tắc, chúng tôi dự kiến sẽ chấp nhận tối đa 2 dự án cho mỗi tổ chức để không tạo ra quá nhiều dự án được chấp nhận. Tuy nhiên, nếu quy trình lựa chọn miễn phí không lấp đầy tất cả các vị trí, thì quản trị viên chương trình của Google có thể phân bổ thêm vị trí cho một số tổ chức.

Do đó, khi gửi các dự án viết kỹ thuật do bạn chọn, bạn có thể chọn nhiều hơn 2 dự án. Hãy nhớ liệt kê các lựa chọn của mình theo thứ tự ưu tiên, trong đó ưu tiên hàng đầu của bạn ở đầu danh sách.

Khi trao đổi với người viết kỹ thuật, bạn nên nói rõ rằng dự án sẽ không được chấp nhận cho đến khi quản trị viên chương trình của Google công bố danh sách các dự án được chấp nhận trên trang web của chương trình.

Tôi có thể tham gia Phần Tài liệu với tư cách là quản trị viên tổ chức và người cố vấn không?

Có. Quản trị viên của tổ chức cũng có thể là người cố vấn. Bạn không cần phải điền vào một biểu mẫu cố vấn riêng. Khi điền vào biểu mẫu đăng ký của tổ chức hoặc biểu mẫu thay thế dành cho quản trị viên, bạn nên chọn lựa chọn trên biểu mẫu đó để cho biết bạn cũng là người cố vấn.

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

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

Tôi có thể tham gia với tư cách là quản trị viên tổ chức hoặc người cố vấn trong cả Phần Tài liệu và Google Code không?

Có. Phần Tài liệu và Google Code-in là các chương trình riêng biệt. Nếu có băng thông để tham gia cả hai chương trình thì không có vấn đề gì.

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

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

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