Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cleanup top level README for better user experience #363

Merged
merged 15 commits into from
Apr 13, 2023

Conversation

riaankleinhans
Copy link
Contributor

Why is this PR needed?

We are in the process collecting info about the work of TAG CS to help with "Create a roadmap for the TAG #341"
Big part of the task for me is to understand the relationship between TAG CS and it's teams & WG's

I created a document about the information I found in the repo and Jay has created a great visual presentation of it. I added links to them in the next TAG CS meeting agenda.

As part of the review of the repo I created this PR to cleanup the top level README for a better user experience. (Especially for people that have no idea what we do or what "TAG" means.)

A second step could be to look at gaps in information and reviewing the charters to maybe have the same flow and information body.

I am starting with a small PR to help make the review burden as light as possible.

Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Copy link
Contributor

@carolynvs carolynvs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for tackling organizing and categorizing our efforts! This will be a very nice improvement for people coming to the group for the first time.

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated

- Dave Sudia ([@thedevelopnik](https://github.com/thedevelopnik)), Ambassador Labs
- Paris Pittman ([@parispittman](https://github.com/parispittman)), Apple
Status: [Proposed](https://github.com/cncf/tag-contributor-strategy/issues/1)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can remove this status paragraph here, the Maintainer's Circle is accepted.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed. Thanks

README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
riaankleinhans and others added 7 commits April 9, 2023 06:59
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Co-authored-by: Carolyn Van Slyck <me@carolynvanslyck.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Co-authored-by: Carolyn Van Slyck <me@carolynvanslyck.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Copy link
Member

@geekygirldawn geekygirldawn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like this streamlined version. I had just one small suggestion.

README.md Outdated
and projects with their own contributor strategies for a healthy project.

If you are looking for how-to resources produced by the TAG, please visit
[contribute.cncf.io](https://contribute.cncf.io/) or have a look at the
contributor, goverance, and related [templates](https://github.com/cncf/project-template).

For people new to this space, you can learn more about [CNCF TAG's](https://github.com/cncf/toc/blob/main/tags/cncf-tags.md) by following the link.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For people new to this space, you can learn more about [CNCF TAG's](https://github.com/cncf/toc/blob/main/tags/cncf-tags.md) by following the link.
For people new to this space, you can learn more about the purpose, objectives, and responsibilities of [CNCF TAGs](https://github.com/cncf/toc/blob/main/tags/cncf-tags.md).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general, I have a preference for not saying "follow this link" since it's implied anyway, but this is just my personal pet peeve, so I reworded it a bit to say more about what they could find out about the TAGs :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree. Updated. Thank you.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree. Updated. Thank you.

riaankleinhans and others added 2 commits April 12, 2023 00:32
Co-authored-by: Dawn Foster <geekygirldawn@gmail.com>
Signed-off-by: Riaan Kleinhans <61125752+Riaankl@users.noreply.github.com>
Copy link
Contributor

@carolynvs carolynvs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@jberkus jberkus merged commit 68fc52d into cncf:main Apr 13, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants