website icon indicating copy to clipboard operation
website copied to clipboard

Add guide to blog contributions

Open sftim opened this issue 8 months ago • 12 comments

Add a dedicated section about contributing to the Kubernetes official blogs.

preview

sftim avatar Mar 14 '25 11:03 sftim

Pull request preview available for checking

Built without sensitive environment variables

Name Link
Latest commit aa361ddcd115d7918d3812b2677bfcc47a19280c
Latest deploy log https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/67e3f79b5792df0007a57cbd
Deploy Preview https://deploy-preview-50092--kubernetes-io-main-staging.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

netlify[bot] avatar Mar 14 '25 11:03 netlify[bot]

I think merging this makes the site overall better (as it stands today), but I intend to polish and squash this PR when I get time.

sftim avatar Mar 15 '25 18:03 sftim

@sftim I agree with your prior comment and am happy to provide another review once you squash and polish so that we can have these changes merged. Thanks again for putting this together!

natalisucks avatar Mar 17 '25 12:03 natalisucks

I'd intended to write about being a writing buddy. Added, hyperlinked, committed, pushed.

sftim avatar Mar 17 '25 17:03 sftim

@sftim it might be a good idea to update the SiG-Docs Blog subproject README (https://github.com/kubernetes/community/blob/master/sig-docs/blog-subproject/README.md) adding the distinction between main and maintainer blog, reviewing the existing sections (submit, review and mainenance) to add new details and link to the new pages that will be published after this PR is closed.

What do you think?

graz-dev avatar Mar 17 '25 18:03 graz-dev

@graz-dev I would prefer to hold off on updating the README particularly regarding the maintainer/main blog distinctions, as we're currently in the processes of discussing with ContribEx the idea of merging the two blogs together, and this guide is hoping to serve the purpose of recruiting more reviewers to a combined blog team (alongside the improvements to contributing blogs itself)

natalisucks avatar Mar 17 '25 18:03 natalisucks

@graz-dev I would prefer to hold off on updating the README particularly regarding the maintainer/main blog distinctions, as we're currently in the processes of discussing with ContribEx the idea of merging the two blogs together, and this guide is hoping to serve the purpose of recruiting more reviewers to a combined blog team (alongside the improvements to contributing blogs itself)

@natalisucks ack! It was just to keep the things aligned, but maybe it's better to wait the decision about the future of the two blogs.

graz-dev avatar Mar 17 '25 18:03 graz-dev

/hold

This tries not to make too much change, but at the same time it's size/xxl now and is documenting a policy that's clearly different from what is written down today.

OK to unhold when there is consensus (or lazy consensus) that we should do that.

sftim avatar Mar 17 '25 20:03 sftim

There's a lot of support for one team; what we do about the two separate index pages isn't yet settled.

sftim avatar Mar 17 '25 20:03 sftim

with my SIG Docs co-chair hat on, I support these changes. would love to hear from @divya-mohan0209 @reylejano @katcosgrove @salaxander and @tengqm so we can get leadership consensus.

natalisucks avatar Mar 20 '25 11:03 natalisucks

I propose dropping the lazy consensus hold after KubeCon EU 2025.

sftim avatar Mar 24 '25 22:03 sftim

Given KubeCon/CloudNativeCon EU is over, and after a great chat with @lmktfy about moving this forward, I'm adding the required approval from docs. I'd love Contributor Comms or another Docs approver to add their LGTM 👍 /hold cancel /approve

natalisucks avatar Apr 07 '25 10:04 natalisucks

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: natalisucks

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment Approvers can cancel approval by writing /approve cancel in a comment

k8s-ci-robot avatar Apr 07 '25 10:04 k8s-ci-robot

/lgtm

windsonsea avatar Apr 08 '25 00:04 windsonsea

LGTM label has been added.

Git tree hash: 97459295d81885c58755eb81b61440dde6c30f3a

k8s-ci-robot avatar Apr 08 '25 00:04 k8s-ci-robot