Repository navigation
alter blog post pushing guidelines and commits to nodejs.org master #8629
Description
so one thing that's been bugging me is the process for blog post publishing in the nodejs.org repo. releases.md states that you should immediately merge the blog post PR, however this goes against every other process we have in the website WG. same goes for pushing to master (looking at you @mikeal). could we at least try to change the document so that there needs to be a signoff by a TSC/CTC member or something?
Activity
[-]alter blog post pushing guidelines and commits to node.org master[/-][+]alter blog post pushing guidelines and commits to nodejs.org master[/+]cjihrig commentedon Sep 17, 2016
FWIW, I think all of the people who have been doing releases are CTC members.
MylesBorins commentedon Sep 17, 2016
@Fene the issue that we will primarily deal with is that when doing a release everything is very time sensitive. In order to generate the release post we need the sha's and size information for all the assets in the tarball. This information is not available to the website tool until the release has been promoted. Once the release is promoted we want to get the post up ASAP.
Adding an extra sign off step will only block to release process IMHO. Seeing as how the the post is 100% generated / automated, it doesn't really make sense to me that it should need sign off.
Is there a halfway point that we can land on this? Would making sure all commits follow the proper guidelines with titles / descriptions?
MylesBorins commentedon Sep 17, 2016
could we include a shorthand in the title that signals that?
For example
I think the issue starts to become one of redundancy... when the body is not saying much more than the title at all.
MylesBorins commentedon Sep 17, 2016
Here is one from @Fishrock123 I like.
Includes a reference to the original PR for the release.
I did just audit the various commits within the website and noticed that there does not appear to be any consistency regarding having a body to a commit. A non trivial number of commits from various wg members appear to be with only a title. As such should we be expecting a higher bar for Blog pr's?
MylesBorins commentedon Sep 17, 2016
@Fene ok. Can you please send a PR to
Release.mdthat outlines the new process? We can make sure to get sign-off from all the releasers before landingMylesBorins commentedon Sep 17, 2016
I would include the full instructions in that document with exactly what
you would like done. pointing to another document can be somewhat frail.
On Sat, Sep 17, 2016, 4:39 PM fen notifications@github.com wrote:
Fishrock123 commentedon Sep 17, 2016
This isn't necessarily true, nor should it be.
I'd be ok with some commit message guidelines, but I think releasers should still always be able to publish immediately.
The same rights also count for the core repo where releasers are able to push releases without other explicit signoff in many cases. This includes updating the changelog in
masterwithout a PR.Requiring a PR for that would just not work with how the release post tooling works here.
cjihrig commentedon Sep 17, 2016
I agree, I was just stating the current reality in response to the comment that TSC/CTC signoff should be required.
MylesBorins commentedon Sep 17, 2016
one thing that I think is important to remember is the purpose of process
process exists to help us succeed as a group. it is not set in stone, note
does it exist for its own sake.
generally productivity will trump process. pushing release notes directly
to master is a great example I had not considered including.
I think the issue here is that of respect. I have been opening prs for all
release posts primarily out of respect to the wg. obviously this had not
been properly conveyed.
i really like the idea of including the pr URL in the body of the commit as
extra meta data, and that being a sign of respect for the process.
to the website wg, I apologize if the process has created an environment
that you feel disrespected. hopefully this new process will work better.
with that being said, I do urge you to consider why certain process exists,
and not be afraid of questioning things before it becomes dogma.
all that aside, respect comes first. thanks for being patient
On Sat, Sep 17, 2016, 7:24 PM Colin Ihrig notifications@github.com wrote:
doc: add commit formats for release blog posts
doc: add commit formats for release blog posts
doc: add commit formats for release blog posts
doc: add commit formats for release blog posts
doc: add commit formats for release blog posts
doc: add commit formats for release blog posts