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

Added blog contributions guidelines #31

Closed
wants to merge 2 commits into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 57 additions & 0 deletions blog-contributions-guidelines.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
# How to get started contributing to the in-toto blog

Welcome to the in-toto community blog. This blog serves as an educational resource for community members, maintainers,users and contributors.

The process is meant to be self-serve but if you experience any difficulties reach out to us at contact us via the [CNCF Slack on the #in-toto](https://cloud-native.slack.com/archives/C8NMD3QJ3) channel.

**TLDR;** submit your blog Pull Request [here](https://github.com/in-toto/in-toto.github.io).

Please read and follow the guidelines. Incomplete submissions will be rejected.

**Content criteria & guidelines**
The community thanks you for your interest in contributing content to the in-toto community blog. Here are examples of content to create and criteria to follow to avoid rejection.

**Articles about The Update Framework**
* Technical content and how-to’s.
* Stories about in-toto how in-toto helped.
* Use cases and success stories about in-toto.
* Industry insight into in-toto and in-toto’s role in the ecosystem
* Industry insight about software update system security and how to use TUF
* Project updates about in-toto.



Next, the blog editor will review the content for any grammatical errors, spelling mistakes, technical accuracy, and provide feedback. All feedback and collaboration will take place in the Github Pull Request.

Depending on where your blog falls in the queue, editing and publication dates will vary. Blog content is reviewed and published on a first come, first serve basis. This step should take 5 - 7 business days to complete.

The goal is to publish 1 blog per week and the community commits to a 2 week(s) turnaround end to end.

**Publishing process**
* Depending on the quality of the content & edits needed this process should take 5 - 10 business days.
* Once the editor and contributor are done with the editing process, the blog should publish when the next available slot opens up.
* See editorial calendar
* Community contributed blogs are published on Tuesday & Thursday on a first come, first serve basis.
* The blog content is published on the in-toto [website](https://in-toto.io/).

**Submit your PR**
Now that you understand the content guidelines and publishing process you are ready to submit your pull request. All blog content must be submitted through this process to be considered for publication.
* How to submit your first PR blog in easy steps
* Step 1: Fork to the [in-tot website repo](https://github.com/in-toto/in-toto.github.io) on Github
* Step 2: Clone locally your branch and create a new branch
* Step 3: Create your blog post in markdown format.
* Step 4: Add images to the [img folder](https://github.com/in-toto/in-toto.github.io/tree/master/assets/images)
* Step 4: Commit your work with a signoff and push to Github
* Step 5: Create your pull request to upstream repo with your changes
Filing your first PR? Go here 👉 [for step by step instructions ](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)

**Promoting your blog**
Finally, once the blog goes live we will promote the content on the in-toto social media handle.

Be sure to provide a headshot and your social media handles so we can tag you in the post. Don’t forget to share your content with your network too!

Blog content will also be submitted for promotion in the following channels:
* [in-toto Slack channel](https://cloud-native.slack.com/archives/C8NMD3QJ3)
* [in-toto Newsletter]()
* [in-toto Twitter handle]()
* [in-toto LinkedIn page]()