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

CNCF website guidelines checklist into sandbox on-boarding template #294

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

nate-double-u
Copy link
Member

Adding information from CNCF website guidelines checklist to sandbox on-boarding tepmplate

* Draft for discussion

@nate-double-u
Copy link
Member Author

"deploy" preview.

- [ ] Submit a [pull request](https://github.com/cncf/artwork) with your artwork.
- [ ] Transfer website analytics to <[email protected]>. CNCF staff can help.
- [ ] Submit a [pull request](https://github.com/cncf/artwork) with your existing artwork.
_Note_: If you don't have artwork, CNCF can help design some.
Copy link
Member Author

Choose a reason for hiding this comment

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

Should we include more info about our design services and how to access them?

- [ ] Transfer website analytics to <[email protected]>. CNCF staff can help.
- [ ] Submit a [pull request](https://github.com/cncf/artwork) with your existing artwork.
_Note_: If you don't have artwork, CNCF can help design some.
- [ ] Transfer website analytics to <[email protected]>, if applicable. CNCF staff can help.
Copy link
Member Author

Choose a reason for hiding this comment

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

If applicable as not all projects will have analytics, and for those that do, it may not be Google Analytics so another transfer method may need to be used.


## Update and document

- [ ] Ensure that [DCO](https://github.com/apps/dco) (preferred) or [CLA](https://github.com/cncf/cla) are enabled for all GitHub repositories of the project.
- [ ] Ensure that that the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md) (or your adopted version of it) are explicitly referenced at the project's `README` on GitHub.
- [ ] Ensure LF footer is on your website and [guidelines](https://github.com/cncf/foundation/blob/main/website-guidelines.md) are followed (if your project doesn't have a dedicated website, please adopt those guidelines for the `README` file).
Copy link
Member Author

Choose a reason for hiding this comment

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

moved to the Websites section.

Comment on lines +53 to +61
- [ ] Ensure website is
- [ ] [Hosted in an open source repo](https://github.com/cncf/techdocs/blob/main/docs/repo-setup.md)
- [ ] Hosted in the same organization as the main project
- [ ] Setup with [DCO](https://github.com/apps/dco) or CLA (DCO recommended)
[CNCF's IP policy](https://github.com/cncf/foundation/blob/master/charter.md#11-ip-policy)
requires all projects to use either CLA (Contributor License Agreements)
or [DCO (Developer Certificate of Origin)](https://github.com/apps/dco).
Unless there's a strong necessity to use CLA, we encourage projects to
use DCO as it's easier to setup and use.
Copy link
Member Author

Choose a reason for hiding this comment

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

This may duplicate some instructions above, particularly line 42 "Ensure that DCO (preferred) or CLA are enabled for all GitHub repositories of the project."

We may want to drop it from here (though we may want to provide some of this info above)

Comment on lines +67 to +68
- [ ] No links or forms for capturing enterprise support leads should be present
_Note_: It is fine to have an enterprise support, commercial partners, or similar page.
Copy link
Member Author

Choose a reason for hiding this comment

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

Suggested change
- [ ] No links or forms for capturing enterprise support leads should be present
_Note_: It is fine to have an enterprise support, commercial partners, or similar page.
- [ ] Remove any links or forms for capturing enterprise support leads
_Note_: It is fine to have an enterprise support, commercial partners, or similar page.

Comment on lines +73 to +74
- [ ] Links to companies offering support go to a page that at least mentions
support of the project
Copy link
Member Author

Choose a reason for hiding this comment

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

Suggested change
- [ ] Links to companies offering support go to a page that at least mentions
support of the project
- [ ] Any links to companies offering support go to a page that _at least_ mentions
support of the project

@krook
Copy link
Member

krook commented Oct 29, 2024

Merged in the latest changes to the template that happened while this PR was opened.

@nate-double-u given that there is a lot of content added here, what do you think about moving it to an external document? Kind of like how we refer projects to review other readmes? I'd say we should keep a hand full of first class checklist items in this template, but then leave other more minor items in an external doc.

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.

2 participants