Skip to content

Commit 0496a1a

Browse files
committed
Add untranslated contents
Signed-off-by: Shu Muto <[email protected]>
1 parent 9e7d627 commit 0496a1a

17 files changed

+571
-0
lines changed

content/ja/contribute/_index.md

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
title: How To Contribute
3+
toc_hide: true
4+
status: Completed
5+
menu:
6+
main:
7+
weight: 10
8+
---
9+
10+
## Welcome
11+
12+
Welcome to the OSPO Glossary contributing guide, and thank you for your interest.
13+
There are a number of ways you can contribute to this project, which we'll cover in detail here:
14+
15+
1) [Best Practices](#best-practices)
16+
2) [Style guide](#style-guide)
17+
3) [Work on an existing issue](#work-on-an-existing-issue)
18+
4) [Propose new terms](#propose-new-terms)
19+
20+
21+
## OSPO glossary overview
22+
23+
The goal of this glossary is to simplify the Open Source Program Office space and thus make it more accessible to people.
24+
25+
The OSPO Glossary content is stored in [this GitHub repo](https://github.com/todogroup/glossary)
26+
where you'll find a list of [issues](https://github.com/todogroup/glossary/issues) and pull requests ([PRs](https://github.com/todogroup/glossary/pulls)).
27+
## Who can contribute?
28+
29+
How you can participate in this project depends on your level of Open Source Program Office / Open Source within organizations expertise.
30+
Simplifying complex concepts requires a deep knowledge of the topic.
31+
Therefore, to contribute new terms, you must be proficient in them.
32+
33+
That know-how is required because explaining complex concepts in simple words is _really_ hard. And while the digestible, user-friendly outcome may seem easy, achieving the desired simplicity results from hard work and collaboration between cloud native experts.
34+
35+
If you have never directly engaging with Open Source Program Offices or open source initiatives within organizations yet, but still want to contribute, we recommend teaming up with someone who is.
36+
Once the expert is confident that the term accurately describes the concept, you are ready for your first Glossary contribution.
37+
38+
The localization effort is where beginners proficient in another language can make valuable contributions to the Glossary.
39+
With solid existing definitions in English, less experienced contributors can localize terms to a target language. You can join an existing localization team or create a new one. Read this guide's [Help Localize the glossary](#help-localize-the-glossary) section to learn how to get started.
40+
41+
## Before you start
42+
43+
Before beginning your Glossary contributor journey, be sure to complete the following steps:
44+
45+
1. Create a [GitHub account](https://docs.github.com/en/get-started/signing-up-for-github/signing-up-for-a-new-github-account), if you don't have one already.
46+
2. Be familiar with the [DCO signature](https://developercertificate.org/) when making contributions.
47+
48+
## Best practices {#best-practices}
49+
50+
To facilitate the reviewing process, please use [semantic line breaks](https://sembr.org/) (e.g., one line per sentence).
51+
We recommend checking out this [markdown cheat sheet](https://www.markdownguide.org/cheat-sheet/)
52+
to correctly format Markdown text in GitHub (e.g., hyperlink, bold, italic).
53+
And when naming .md files, please use lowercase letters and hyphens instead of spaces to separate words and avoid parenthesis.
54+
55+
## Style guide {#style-guide}
56+
57+
Read our [Style Guide](/style-guide/) to understand our guidelines for formatting and writing documents and make the contribution process more efficient.
58+
59+
## Work on an existing issue {#work-on-an-existing-issue}
60+
61+
Go to the [Glossary GitHub repo issues](https://github.com/todogroup/glossary/issues) to find a list of available issues.
62+
You can use labels (e.g., English language, help needed, good first issue) to filter out issues.
63+
64+
**Note**: you can start working on an issue after the maintainers assigned it to you.
65+
You can only claim one term at a time.
66+
Working on multiple terms is sequential, you must complete a term before claiming the next one.
67+
68+
## Propose new terms {#propose-new-terms}
69+
70+
You can propose a new term for others to work on or create a new definition yourself.
71+
Either way, you'll start by [creating an issue](#creating-an-issue).
72+
73+
74+
**We updated this guide based on templates from [The Good Docs Project](https://thegooddocsproject.dev/).**
Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
---
2+
title: Contributor Ladder
3+
toc_hide: true
4+
status: Completed
5+
menu:
6+
main:
7+
weight: 10
8+
---
9+
10+
Hi there! 👋 Thanks for your interest in contributing to the TODO Glossary project.
11+
Whether you contribute new terms, help localize the Glossary into your native language,
12+
or want to help others get started, there are many ways to become an active member of this community.
13+
This doc outlines the different contributor roles within the project and the responsibilities and privileges that come with them.
14+
15+
## 1. Contributors
16+
17+
The Glossary is for everyone. Anyone can become a Glossary contributor simply by contributing to the project.
18+
All contributors are expected to follow the [TODO Code of Conduct](https://todogroup.org/code-of-conduct/).
19+
20+
There are a variety of ways you can contribute to the project, including:
21+
22+
- **Content contributors**: everyone who improves existing terms or contributes new ones,
23+
- **Localization contributors**: those who help translate the glossary into another language,
24+
- **Helpers**: anyone who helps others on GitHub, Slack, or wherever community members need support,
25+
- **Ambassadors**: anyone who helps spread the word, educates the community on how to contribute and why they should do so.
26+
27+
Contributors can have multiple roles or focus on one area only.
28+
**All these contributions are equally important** and help foster a thriving community.
29+
Please refer to the [How to Contribute](/contribute/) and [Style Guide](/style-guide/) for content and localization contributions.
30+
31+
## 2. Approvers
32+
33+
Approvers provide feedback on PRs and approve them. Any active contributor can become an approver (see [Becoming an approver](#becoming-an-approver)).
34+
The Glossary differentiates between two approvers: (1) approvers for the English Glossary and (2) approvers for localization teams.
35+
36+
Glossary approvers are expected to:
37+
38+
- Review PRs for technical accuracy,
39+
- Assign contributors issues and label them appropriately,
40+
- Provide contributors with feedback and guide them when needed,
41+
- Proofread and edit submissions.
42+
43+
If an approver is no longer interested in or cannot perform the above duties, they should let the maintainers know and step down.
44+
45+
### English Glossary Approvers
46+
47+
There are three types of approvers:
48+
49+
1) Approvers with a strong technical background,
50+
2) Approvers with solid writing skills,
51+
3) Approvers who are proficient in both.
52+
53+
**Technical Approvers**: Individuals with a strong technical background can be approvers without having solid English writing skills.
54+
However, if they approve a PR on technical merit, they must ensure it is reviewed by an (editor) approver.
55+
56+
**Editors**: Editors proofread terms and ensure they are explained in simple language according to the Style Guide.
57+
If a term is heavily edited, the editor must request a technical approver to review it again to ensure the meaning wasn't altered.
58+
59+
### Localization Approvers
60+
61+
The Glossary also has localization approvers. These are approvers for one of the localization teams (teams translating the glossary).
62+
Localization approvers are only permitted to perform approver duties for their own team and have the ability to merge PRs to their dedicated development branch.
63+
Any localization approver can also become an approver for the English Glossary if they meet the requirements.
64+
65+
### Becoming an Approver
66+
67+
Approver candidates should have a proven track record of submitting high-quality PRs and helping others get their PRs in a mergeable state.
68+
69+
To become an approver, start by expressing interest to existing maintainers.
70+
Existing maintainers will then ask you to demonstrate the qualifications above by contributing PRs, doing reviews, and doing other such tasks under their guidance.
71+
After some time of working together, maintainers will decide whether to grant you approver status.
72+
This decision will be based on your demonstrated level of proficiency and responsiveness.
73+
74+
## 3. Maintainers
75+
76+
Maintainers are approvers who can also merge PRs. Anyone can become a Glossary maintainer (see [Becoming a maintainer](#becoming-a-maintainer)).
77+
There are certain expectations for maintainers, including:
78+
79+
- Be an active and responsive approver (see above),
80+
- Help maintain the repository, including site configuration, permission, issue-template, GitHub workflow, among others,
81+
- Monitor the Glossary Slack channels and help out whenever possible,
82+
- Regularly attend the [Glossary Working Group meetings](https://www.cncf.io/calendar/) (if timezone permits)
83+
84+
If a maintainer is no longer interested in or cannot perform the duties listed above, they should move themselves to emeritus status.
85+
86+
### Becoming a Maintainer
87+
88+
Maintainers should have a proven track record of being successful approvers and submitting high-quality PRs.
89+
If their timezone permits, they should also regularly attend the Glossary Working Group meetings.
90+
91+
To become a maintainer, start by expressing interest to existing maintainers.
92+
Existing maintainers will then ask you to demonstrate the qualifications above by contributing PRs, doing reviews, and doing other such tasks under their guidance.
93+
After some time of working together, maintainers will decide whether to grant maintainer status.
94+
This decision will be based on demonstrated level of proficiency and responsiveness.
95+
96+
## Involuntary Removal
97+
98+
Involuntary removal of a contributor happens when responsibilities and requirements aren't met.
99+
This may include repeated patterns of inactivity, extended periods of inactivity, and/or a violation of the code of conduct.
100+
This process is important because it protects the community and its deliverables while also opening up opportunities for new contributors to step in.
101+
102+
## Stepping Down/Emeritus Process
103+
104+
If and when contributors' commitment levels change, contributors can consider stepping down (moving down the contributor ladder) vs.
105+
moving to emeritus status (completely stepping away from the project).
106+
107+
## Stepping Back Into a Role
108+
109+
If and when someone is available to step back into a previous contributor role, project leadership can arrange and consider this.
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: InnerSource Principles
3+
status: Completed
4+
tags: ["fundamental", "culture", ""]
5+
---
6+
7+
InnerSource Principles are a set of guidelines that provide a framework for organizations to tap into the collective knowledge and expertise of their employees, and to create a culture of collaboration and innovation.
8+
9+
## 💻 Source
10+
11+
* [InnerSource Commons](https://innersourcecommons.org/learn/).
12+

content/ja/innersource.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: InnerSource
3+
status: Completed
4+
tags: ["fundamental", "culture", ""]
5+
---
6+
7+
The use of open source software development best practices and the establishment of an open source-like culture within organizations for the development of its non-open-source and/or proprietary software. [InnerSource](https://innersourcecommons.org/) is a close sibling of open source and often collaborates with or is part of the OSPO. [Learn more](https://innersourcecommons.org/)
8+
9+
# 💻 Source
10+
11+
* [InnerSource Commons Foundation](https://innersourcecommons.org/)
12+

content/ja/knowledge-sharing.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: Knowledge Sharing
3+
status: Completed
4+
tags: ["fundamental", "", ""]
5+
---
6+
7+
Knowledge sharing refers to the exchange of information and expertise between individuals, teams, and organizations. Knowledge sharing is often a key component of open source and innerSource development practices. [Learn more about knowledge sharing](https://en.wikipedia.org/wiki/Knowledge_sharing).
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: Open Data and Content
3+
status: Completed
4+
tags: ["fundamental", "", ""]
5+
---
6+
7+
The [Open Definition](http://opendefinition.org/od/2.1/en/) sets out principles that define *openness* in relation to data and content. Open means anyone can freely access, use, modify, and share for any purpose (subject, at most, to requirements that preserve provenance and openness).
8+
Open data and content can be freely used, modified, and shared by anyone for any purpose.
9+
10+
## 💻 Source
11+
12+
* [Open Knowledge Initiative](https://okfn.org/)

content/ja/open-innovation.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
title: Open Innovation
3+
status: Completed
4+
tags: ["fundamental", "", ""]
5+
---
6+
7+
Open innovation assumes that useful knowledge is widespread, so that one needs to innovate by developing effective mechanisms to access this useful knowledge, and to share useful knowledge with others.
8+
Open Innovation is based on the fundamental idea that useful knowledge is now widespread throughout society. No one organization has a monopoly on great ideas, and every organization,
9+
no matter how effective internally, needs to engage deeply and extensively with external knowledge networks and communities. An organization that practices open innovation will utilize external
10+
ideas and technologies as a common practice in their own business and will allow unused internal ideas and technologies to go to the outside for others to use in their respective businesses.
11+
12+
## 💻 Source
13+
14+
* [European Commission Open Innovation Definition](https://digital-strategy.ec.europa.eu/en/news/what-open-innovation)

content/ja/open-source-culture.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: Open Source Culture
3+
status: Completed
4+
tags: ["fundamental", "", ""]
5+
---
6+
7+
Open source culture refers to a set of values and practices that promote collaboration, transparency, and community-driven development. It is often associated with the open source software movement, but can be applied to other areas as well, such as open science, open hardware, and open education. This Glossary references the four opens philosophy, created by the Open Infra (former OpenStack) community. [Learn more](https://openinfra.dev/four-opens/).
8+
9+
## 💻 Source
10+
11+
* [Open Infrastructure Foundation](https://openinfra.dev/four-opens/)
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: Open Source Software Ecosystems
3+
status: Completed
4+
tags: ["fundamental", "", ""]
5+
---
6+
7+
To understand what an open source software ecosystem is, researchers https://upcommons.upc.edu/handle/2117/87103 have first explored the definition of
8+
software ecosystems. According to [this research](https://upcommons.upc.edu/handle/2117/8710), some widely accepted definitions of software ecosystems are:
9+
10+
* *A set of actors functioning as a unit and interacting with a shared market for software and services, together with the relationships among them*
11+
* *A collection of software projects which are developed and evolve together in the same environment*.
12+
* *A set of software solutions that enable, support, and automate the activities and transactions by the actors in the associated social or business ecosystem and the organizations that provide these solutions*
13+
14+
Regarding open source software ecosystems, there are only a few [specific definitions provided by authors Wynn and Hoving](https://upcommons.upc.edu/handle/2117/87103). They base their definitions on key factors like the shared market, organizations, and capital, which are vital in supporting the open source software community. Some widely accepted definitions of open source software ecosystems are:
15+
16+
* A Software Ecosystem placed in a heterogeneous environment
17+
* Its boundary is a set of niche players
18+
* The keystone player is an OSS community around a set of projects in a common platform
19+
20+
## 💻 Source
21+
22+
* [Franco, O. Open source software ecosystems: towards a modeling framework](https://upcommons.upc.edu/handle/2117/87103)

content/ja/open-source.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: Open Source
3+
status: Completed
4+
tags: ["fundamental", "", ""]
5+
---
6+
7+
Open source refers to a type of software that allows users to freely use, modify, and distribute the source code of a program that must comply with certain distribution criteria.
8+
9+
## 💻 Source
10+
11+
* [Open Source Initiative](https://opensource.org/osd/)

0 commit comments

Comments
 (0)