Cách bẻ khóa quy trình đăng ký phần tài liệu của Google cho năm 2020

Trong những năm qua, các cuộc khảo sát đã cho thấy tầm quan trọng của tài liệu tốt trong cách các nhà phát triển lựa chọn và sử dụng mã nguồn mở.

Trong chương trình Google Season of Docs (GSoD) khai mạc vào năm 2019, chương trình đã nhận được gần 450 đơn đăng ký người viết kỹ thuật và hơn 50 người viết kỹ thuật đã được chấp nhận.

Là một trong những người viết kỹ thuật được chấp nhận tham gia vào chương trình Google Season of Docs, tôi muốn chia sẻ một số thông tin chi tiết về cách chuẩn bị và tạo một ứng dụng mạnh mẽ cho chương trình GSoD.

Mục lục

  • Phần Google Tài liệu là gì?
  • Ai đủ điều kiện tham gia chương trình?
  • Lợi ích khi tham gia
  • 5 mẹo để áp dụng GSoD của bạn
  • Trải nghiệm GSoD của tôi
  • Tài nguyên hữu ích

Phần Google Tài liệu là gì?

Season of Docs là một chương trình thường niên do Google tổ chức. Mục tiêu của nó là tập hợp các nhà văn kỹ thuật và các tổ chức nguồn mở lại với nhau để thúc đẩy sự hợp tác và cải tiến tài liệu trong không gian Nguồn mở.

Sáng kiến ​​này cực kỳ quan trọng vì tài liệu của một dự án Nguồn mở cung cấp một con đường để người dùng không chỉ hiểu dự án mà còn đóng góp cho nó.

Trong suốt chương trình, những người viết kỹ thuật được chấp nhận dành từ 3-5 tháng để xây dựng một bộ tài liệu mới, cải thiện cấu trúc của các tài liệu hiện có, phát triển một hướng dẫn rất cần thiết hoặc cải thiện các quy trình đóng góp và hướng dẫn của một tổ chức Nguồn mở.

Ai đủ điều kiện tham gia chương trình?

Theo quy định của Google, bạn phải từ 18 tuổi trở lên tại thời điểm đăng ký. Bạn cũng phải có kinh nghiệm trước đó với tư cách là một nhà văn kỹ thuật và đủ điều kiện để làm việc tại quốc gia cư trú của bạn.

Nếu bạn đáp ứng các tiêu chuẩn này, thì bạn có thể đăng ký tham gia vào chương trình Google Season of Docs.

Lợi ích khi tham gia

Bạn có rất nhiều lợi ích khi tham gia chương trình Phần tài liệu. Một số thì:

Bạn có thể nhận được một khoản phụ cấp

Sau khi bạn hoàn thành chương trình Google Season of Docs, bạn sẽ được Google trả một khoản phụ cấp. Điều quan trọng cần lưu ý là khoản phụ cấp này là tùy chọn, vì vậy bạn phải cho biết rằng bạn muốn được thanh toán trong giai đoạn đăng ký.

Số tiền trợ cấp được tính dựa trên vị trí của bạn. Xem ở đây để biết chi tiết đầy đủ về tiền lương.

Bạn cải thiện kỹ năng của mình

Một lợi ích rõ ràng khác khi tham gia vào chương trình Google Season of Docs là nó cho phép bạn cải thiện kỹ năng của mình với tư cách là người viết kỹ thuật.

Bạn mở rộng mạng lưới của mình

Ngoài việc cải thiện với tư cách là một nhà văn kỹ thuật, bạn còn có cơ hội làm việc với những người đang làm những điều tuyệt vời trong Không gian nguồn mở.

Trong trường hợp của tôi, tôi có cơ hội làm việc với tổ chức VideoLAN và điều đó có nghĩa là tôi phải làm việc chặt chẽ với chủ tịch của tổ chức và những người đóng góp lớn cho các dự án.

Bạn có thể nhận được đề xuất và giới thiệu

Khi nộp đơn cho bất kỳ công việc nào, có một thư giới thiệu tốt thường giúp củng cố hồ sơ của bạn.

Hợp tác chặt chẽ với người cố vấn trong dự án Season of Docs mang đến cơ hội để đảm bảo nguồn giới thiệu và đề xuất phong phú.

Bạn có quyền truy cập vào các cơ hội trong tương lai

Nếu bạn đã sẵn sàng ứng tuyển vai trò viết kỹ thuật tại Google, việc bao gồm trải nghiệm Phần tài liệu trong lý lịch của bạn sẽ mang lại cho bạn nhiều lợi thế hơn so với những ứng viên khác.

Bạn trở thành cộng tác viên Nguồn mở

Bên cạnh tất cả các lợi ích đã đề cập ở trên, tham gia chương trình Tài liệu mùa có nghĩa là bạn có thể đóng góp cho các dự án Nguồn mở. Điều này giúp thế giới xóa bỏ định kiến ​​rằng Đóng góp nguồn mở chỉ dành cho các nhà phát triển phần mềm.

5 mẹo để áp dụng GSoD của bạn

Dưới đây là 5 mẹo giúp bạn chuẩn bị và tạo một ứng dụng mạnh mẽ cho chương trình Phần tài liệu.

Tạo và xuất bản các bài viết trên blog của bạn

Một trong những tiêu chí quan trọng nhất để được chấp nhận làm nhà văn kỹ thuật trong chương trình Google Season of Docs là khả năng thể hiện rằng bạn đã có kinh nghiệm viết trước đó.

Google và những người cố vấn được đề xuất của dự án mà bạn muốn làm việc cần được thuyết phục rằng bạn là người phù hợp để làm việc trong dự án. Điều này có nghĩa là họ muốn xem nhiều tài liệu và bài báo được viết tốt mà bạn đã tạo.

Rất may, vẫn chưa muộn để tạo blog hoặc xuất bản thêm nội dung trên blog đã có của bạn.

Nếu bạn đã có một blog, bạn nên xuất bản nhiều bài viết hay hơn trước, trong và sau khi bạn gửi đề xuất của mình. Nếu bạn không có bất kỳ blog nào, vẫn chưa quá muộn để tạo một blog bằng Devblog của Hashnode hoặc nền tảng ưa thích của bạn và xuất bản các bài báo viết hay.

Chọn đúng dự án Nguồn mở

Thành thật mà nói, tôi không thể nhấn mạnh quá mức tầm quan trọng của việc chọn đúng dự án Nguồn mở. Điều này là do nó đóng một vai trò quan trọng trong việc đưa bạn vào chương trình.

Dưới đây là suy nghĩ của tôi về việc lựa chọn dự án phù hợp:

  • Xem qua tất cả các dự án đã được phê duyệt và cố gắng chọn ít nhất 5 dự án mà bạn quan tâm.
  • Sau khi chọn ít nhất 5 dự án, hãy quét qua một lần nữa và giảm các dự án xuống còn tối đa 3 dự án và tối thiểu là 2 dự án.
  • Mặc dù có thể hợp lý khi tập trung vào một dự án trong giai đoạn nộp đơn, nhưng tôi khuyến khích bạn đăng ký ít nhất hai dự án để cải thiện cơ hội được chấp nhận cho ít nhất một dự án.
  • Đối với mỗi dự án bạn chọn, hãy tham gia kênh liên lạc của tổ chức và cho những người duy trì dự án biết về sự quan tâm của bạn đối với dự án đó. Bằng cách đó, bạn sẽ có thể thiết lập mối quan hệ giữa mình và người cố vấn. Ngoài ra, hãy lưu ý rằng người cố vấn không chọn người chỉ vì họ có các kỹ năng cần thiết. Họ cũng chọn các ứng viên vì họ tin rằng họ cũng có thể làm việc với họ. Vì vậy, khi bạn gửi tin nhắn cho một người cố vấn, hãy nói rõ ràng về chính xác những gì bạn cần và quan trọng nhất là đừng bực bội vì họ đã không trả lời ngay lập tức vì hầu hết những người cố vấn là những người tình nguyện có công việc toàn thời gian khác.
  • Đừng đợi để được đút bằng thìa. Thực hiện rất nhiều nghiên cứu về dự án. Khám phá và hiểu mọi thứ bạn cần biết và nếu bạn có bất kỳ mối quan tâm nào, hãy liên hệ với người cố vấn được đề xuất của dự án đó để được trợ giúp hoặc hỏi các thành viên khác của cộng đồng đó.
  • Quan trọng nhất, hãy viết ra bất cứ điều gì bạn khám phá được trong quá trình nghiên cứu sẽ hữu ích nếu bạn được chấp nhận làm việc trong dự án hoặc thông tin sẽ giúp cải thiện đề xuất của bạn.

Viết đề xuất

Rất nhiều người không biết điều này, nhưng viết một đề xuất là rất quan trọng. Nó cung cấp cho bạn sự hiểu biết rõ ràng về mục tiêu của dự án, tiến trình thời gian để bạn hoàn thành dự án, những gì bạn cần biết, v.v.

Bên cạnh đó, việc viết đề xuất cũng cho người cố vấn của bạn thấy mục tiêu của bạn đối với dự án, lý do tại sao bạn tin rằng bạn là người phù hợp với vai trò, kinh nghiệm của bạn, tiến trình dự án và hơn thế nữa.

Sau khi viết đề xuất của bạn, hãy gửi nó cho người cố vấn của dự án để xem xét. Đánh giá của họ sẽ giúp bạn biết các yêu cầu của dự án theo quan điểm của người cố vấn. Tôi đã thêm một liên kết vào đề xuất Phần tài liệu trên Google của mình trong phần Tài nguyên.

Đóng góp ít nhất một lần cho Tổ chức Nguồn mở

Chương trình Season of Docs không giống như Google Summer of Code, nơi bạn bắt buộc phải đóng góp ít nhất một đóng góp cho dự án Nguồn mở mà bạn quan tâm. Nhưng đóng góp chắc chắn có thể cải thiện cơ hội được chấp nhận, vì vậy hãy cố gắng làm như vậy.

Tiếp tục hoạt động trong cộng đồng sau thời hạn nộp đơn

Sau khi gửi đơn đăng ký của bạn, hãy cố gắng duy trì hoạt động trong tổ chức Nguồn mở đó. Điều này cho các cố vấn biết rằng bạn đam mê dự án đó và cộng đồng Nguồn mở nói chung.

Trải nghiệm GSoD của tôi

Trong chương trình GSoD năm ngoái, tôi đã có cơ hội làm việc với tổ chức VideoLAN về dự án Hiện đại hóa (viết lại) tài liệu người dùng VLC.

Sau khi đề xuất của tôi được tổ chức VideoLAN chấp nhận, những người cố vấn của tôi và tôi đã đồng ý về các mục tiêu mà tôi dự kiến ​​sẽ đạt được trong chương trình Google Season of Docs.

Đây là những mục tiêu của tôi:

  1. Cơ cấu lại tài liệu.
  2. Cập nhật tài liệu để phù hợp với các phiên bản hiện đại của VLC.
  3. Di chuyển tài liệu người dùng sang Gitlab bằng Sphinx và ReadtheDocs.
  4. Loại bỏ hình ảnh và thông tin lỗi thời.
  5. Viết lại tài liệu người dùng để dễ hiểu.
  6. Thiết lập nó để dịch bằng Sphinx Internationalization.

Tôi đã tìm hiểu thêm rất nhiều về tổ chức VideoLAN và VLC, tôi phát hiện ra rằng VLC có nhiều tính năng hơn mà tôi chưa từng biết và tôi đã học cách sử dụng nền tảng tài liệu Sphinx và cấu trúc lại văn bản.

Kỹ năng viết kỹ thuật của tôi cũng được cải thiện rất nhiều. Nhìn chung, tham gia vào chương trình Google Season of Docs là một trong những điều tuyệt vời nhất đã xảy ra với tôi trong năm 2019.

Tài nguyên hữu ích

Dưới đây là danh sách các tài nguyên hữu ích để giúp bạn tìm hiểu thêm về chương trình Phần của Tài liệu và Kỹ thuật Viết.

  • Đề xuất Phần tài liệu được chấp nhận của tôi
  • Báo cáo dự án Phần tài liệu của Google
  • Đóng góp nguồn mở: Chất xúc tác cho tăng trưởng
  • Hướng dẫn cho người viết kỹ thuật
  • Kênh Season of Docs Slack
  • Viết kỹ thuật tuyệt vời

Thích bài viết này? Theo dõi @Didicodes trên Twitter.