Glossary

[carolynvs]

Add a glossary of terms (not technical) related to how the CNCF and its projects are organized that we use in the CNCF and on contribute.cncf.io.

It should be a new page located at contribute.cncf.io/glossary. If you need help with the Hugo templates/page design, etc, please reach out and we can get assistance. When in doubt, just focus on creating the appropriate text and a page for it, and we can have the CNCF help with the web design.

If you are looking for inspiration a great example to copy would be glossary.cncf.io

[carolynvs]

Here are some common terms used on the site that we can use to kick off the glossary. I am providing some guidance on the definition but we really need someone to look for existing definitions from other sources (such as cncf repositories or the cncf glossary https://glossary.cncf.io/) and make sure we are linking whenever possible to canonical documentation for the term.

• CNCF - Cloud Native compute foundation (add link to cncf site)
• TAG - Technical Advisory Group is a group appointed by the CNCF Technical Oversight Committee (TOC) to assist with a specific subdomain such as security or networking. You can find a list of tags at https://github.com/cncf/toc/blob/main/tags/README.md.
• TOC - Technical Oversight Committee (add link to github.com/cncf/toc). The CNCF Technical Oversight Committee is the technical governing body of the CNCF Foundation. It admits and oversees all projects in the CNCF Foundation and has a mandate to facilitate driving neutral consensus for:
  • defining and maintaining the technical vision for the Cloud Native Computing Foundation,
  • approving new projects within the scope for CNCF set by the Governing Board (GB), and create a conceptual architecture for the projects, aligning projects, removing or archiving projects,
  • accepting feedback from end user committee and map to projects,
  • aligning interfaces to components under management (code reference implementations before standardizing), and defining common practices to be implemented across CNCF projects, if any.
• SIG - Special Interest Group, commonly used by the Kubernetes project to organize contributors around specific topics for further development. Link to https://github.com/kubernetes-sigs
• Working Group - Within a SIG or TAG, we may organize a smaller group of people who are working on a specific sub-area within the group.
• Charter
• Governance
• Maintainer (this varies between projects but could generally be defined as people with commit access to the project repository)
• Contributor (again this varies but should be inclusive and provide for both code and non-code contributions such as project management, content, documentation, user support and more.

The terms we put in our glossary should not be technical terms and should be related to the organization of CNCF and its projects.

[carolynvs]

I can't official assign @dankingkong to the issue but he is working on it. ✅

[dankingkong]

@carolynvs, I have done a PR for the glossary. Please let me know if this is what you were wanting.
Cheers.
Dan

[carolynvs]

It's looking really good but I haven't had time yet to review more closely. I have asked another person on the TAG to give it a look but we may not get to it for another day or two.

[dankingkong]

That's great, no problem with the timing.

…

On Tue, Feb 7, 2023 at 11:34 AM Carolyn Van Slyck ***@***.***> wrote: It's looking really good but I haven't had time yet to review more closely. I have asked another person on the TAG to give it a look but we may not get to it for another day or two. — Reply to this email directly, view it on GitHub <#140 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/A3R5TEJH5GJ5LVT2EX5GHSDWWF4ALANCNFSM5H3EQCLA> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[dankingkong]

On another note, would you or any of your colleagues be able to point me in the right direction to learn more about how Project management works in the open-source community? I am doing an internship with ii Limited and am currently focusing on learning the best systems and practices in Project Management for open-source projects. I am new to the IT industry, but I have run my own home automaton/audio visual/electrical company, as well as leading/managing teams in not-for-profit organisations, so I have some experience managing projects and people. I aim to find some well-managed, open-sourced projects and sit in on their governance meetings to observe how things are run and contribute if I can. I would also like to find some experienced project managers doing a great job and get some mentoring from them. I appreciate any pointers that you could give me. Cheers. Dan

…

On Tue, Feb 7, 2023 at 11:39 AM Daniel King ***@***.***> wrote: That's great, no problem with the timing. On Tue, Feb 7, 2023 at 11:34 AM Carolyn Van Slyck < ***@***.***> wrote: > It's looking really good but I haven't had time yet to review more > closely. I have asked another person on the TAG to give it a look but we > may not get to it for another day or two. > > — > Reply to this email directly, view it on GitHub > <#140 (comment)>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/A3R5TEJH5GJ5LVT2EX5GHSDWWF4ALANCNFSM5H3EQCLA> > . > You are receiving this because you were mentioned.Message ID: > ***@***.***> >

[carolynvs]

Every project is run differently depending on its size, complexity and available volunteers. Projects with maintainers and contributors who are paid to work on it, such as kubernetes, are more likely to have people dedicated to PM, while others may not have sufficient people/time to do that (like this TAG). 😁

A better place to ask off-topic questions by the way would be our Slack channel, mailing list or the discussions forum on this repo. Otherwise it derails the original issue and is hard for people to track and find later.

[aliok]

I created #395 for the website setup. If people agree with that setup, somebody can focus on writing the missing text and we would be good to go.

[aliok]

There's a demand for this kind of less-technical glossary :)

Slack message from @TheFoxAtWork (link):

Do you all happen to have some definitions around contributor, committer, maintainer, commit bit, owner, etc. wrt open source projects? We seem to use these terms a lot in the TOC repo and elsewhere but i can’t actually find where we explain what they are and what they mean. This information is useful for individuals not familiar with these concepts in open source or more specifically how they are used and leveraged in CNCF. See this comment on a TOC PR.