In 2020 the Apache Software Foundation Community published a survey[1] which suggests that language can be one of the major barriers to contribute to any open source project. According to some estimates[2] in Latin America, open source technologies will grow five times in the coming years. Talented professionals, students and enthusiasts demand access to documentation written in their own language. That's why the Spanish documentation team has been participating in different initiatives to help others to contribute into the translation process. During this session, it's going to be shared what the Kubernetes Spanish documentation team has been accomplished and walkthrough the process to translate and contribute to the CNCF documentation. The prime audience for this sessions are spanish-speaking professionals and enthusiasts willing to participate in improving the CNCF documentation. They will understand the workflow to submit documentation changes and help to participate in the localization process. [1] https://cwiki.apache.org/confluence/download/attachments/158865837/The%202020%20ASF%20Community%20Survey%20-%20Readout%20%281%29.pdf?api=v2 [2] http://www.latinamerica.tech/2019/11/12/latins-contribute-little-to-open-source-software/
2. Removing Language Barriers for
Spanish-speaking Professionals
Rael Garcia, RedHat
Victor Morales, Samsung
3. Victor Morales
OpenStack, OPNFV, ONAP and CNCF contributor
Contributor at Kubernetes
kubernetes.io
Sr. Staff Software Engineer at Samsung
samsung.com
electrocucaracha.com
v.morales@samsung.com
You can find me at
@electrocucarach
4. Rael Garcia
Organizer at KCD Spain
kcspain.com
Organizer at Cloud Native Barcelona
cloudnative.barcelona
Contributor at Kubernetes
kubernetes.io
Site Reliability Engineer at Red Hat
redhat.com
rael.io
rael@redhat.com
You can find me at @raelga
10. SIGs Special Interest Groups
Comprised of members from multiple
companies and organizations, with a common
purpose of advancing the project with
respect to a specific topic
UGs User Groups
Centralized resource to facilitate
communication and discovery of information
related to the topic of the user group
WGs Working Groups
Primarily used to facilitate topics of discussion
that are in scope for Kubernetes but that cross
SIG lines
Committees
Closed groups formed to discuss topics which
require discretion
git.k8s.io/community/governance.md
Governance
14. Contribute
Take a look Contributor Role Board
discuss.kubernetes.io/c/contributors/role-board
Look for an interesting topic
git.k8s.io/community/sig-list.md
Code in your preferred programming language
github.com/kubernetes-client
Contribute with non-code contributions
git.k8s.io/community/contributors/guide/non-code-contributions.md
15. Get involved in the contributor
experience
Join to the Contributors Experience SIG at #sig-contribex slack channel
#sig-contribex
Get inspired by Nikhita Raghunath with the How to Contribute to Kubernetes talk
www.youtube.com/watch?v=yVOCRrK6Fh0
Check the Kubernetes Mentoring Initiatives
discuss.kubernetes.io/c/contributors/mentorship
16. Look for issues
Look for issues in your SIG
https://github.com/kubernetes/kubernetes/issues
Search for labels help wanted .
This label indicates that a help is needed.
It most to meet the criteria defined by documentation.
Start with the labels with good first issue .
This indicates an issue was created for new contributors.
It most to meet the criteria defined by documentation.
17. Read the Docs
Read the contributing guides
git.k8s.io/community/contributors/guide
Read the development guides
git.k8s.io/community/contributors/devel
Understand basic and advanced concepts
kubernetes.io/docs/concepts
Read Kubernetes Design Documents and Proposals
git.k8s.io/community/contributors/design-proposals
18. Write the Docs
Join to the Documentation team
git.k8s.io/website
Join to SIG-Docs Slack channel
#sig-docs
Write and improve the documentation
kubernetes.io/docs/contribute/
Write content
kubernetes.io/blog
discuss.kubernetes.io
19. Write the Docs in your language
Join to your native language slack channel
- #kubernetes-docs-de
- #kubernetes-docs-es
- #kubernetes-docs-fr
- #kubernetes-docs-hi
- #kubernetes-docs-id
- #kubernetes-docs-it
- #kubernetes-docs-ja
- #kubernetes-docs-ko
- #kubernetes-docs-pt
- #kubernetes-docs-zh
Write content in your native language
discuss.kubernetes.io/c/regional-discussions
20. Participates in the Spanish
documentation
Participates in the revision of Pull Requests
bit.ly/k8s-sig-docs-es-prs
Add new content to the documentation
bit.ly/k8s-sig-docs-es-m1
Join to the weekly meetings
#kubernetes-docs-es
21. Linux Foundation CLA
The Contributor License Agreement
Defines the legal status of the contributed code in two
different types of Contributor License Agreements (CLAs):
🏠 Individual contributors
🏢 Corporations
Kubernetes can only accept original source code from CLA
signatories
https://git.k8s.io/community/CLA.md
linuxfoundation.org
22. Hugo
The Kubernetes documentation is written in Markdown and processed and deployed using Hugo.
Hugo is one of the most popular open-source static site generators
https://github.com/gohugoio/hugo
Read the Hugo documentation if you want to learn more
https://gohugo.io/documentation/
Check the documentation style guide
https://kubernetes.io/docs/contribute/style/style-guide/
gohugo.io
24. Netlify
The Kubernetes is built and deployed using Netlify
https://app.netlify.com/sites/kubernetes-io-main-staging/deploys
https://github.com/apps/netlify
46. Gopher Kubernetes by @ashleymcnamara
This presentation is licensed under a Creative Commons Attribution 4.0 International License.
See https://creativecommons.org/licenses/by/4.0/ for more details.