Skip to content

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

  1. ghost changed the title [-]alter blog post pushing guidelines and commits to node.org master[/-] [+]alter blog post pushing guidelines and commits to nodejs.org master[/+] on Sep 17, 2016
  2. cjihrig commented on Sep 17, 2016

    @cjihrig
    Contributor

    FWIW, I think all of the people who have been doing releases are CTC members.

  3. MylesBorins commented on Sep 17, 2016

    @MylesBorins
    Contributor

    @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?

  4. MylesBorins commented on Sep 17, 2016

    @MylesBorins
    Contributor

    could we include a shorthand in the title that signals that?

    For example

    release-post: v4.5.1
    
    This commit includes a blog post with release information for v4.5.1
    

    I think the issue starts to become one of redundancy... when the body is not saying much more than the title at all.

  5. MylesBorins commented on Sep 17, 2016

    @MylesBorins
    Contributor

    Here is one from @Fishrock123 I like.

    Blog: v6.6.0 release post
    
    Refs: https://github.com/nodejs/node/pull/8466
    

    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?

  6. added
    metaIssues and PRs related to the general management of the project.
    on Sep 17, 2016
  7. MylesBorins commented on Sep 17, 2016

    @MylesBorins
    Contributor

    @Fene ok. Can you please send a PR to Release.md that outlines the new process? We can make sure to get sign-off from all the releasers before landing

  8. MylesBorins commented on Sep 17, 2016

    @MylesBorins
    Contributor

    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:

    @thealphanerd https://github.com/TheAlphaNerd can i edit the document
    to link to guidelines that i'll add in the website repo?

    —
    You are receiving this because you were mentioned.
    Reply to this email directly, view it on GitHub
    #8629 (comment), or mute
    the thread
    https://github.com/notifications/unsubscribe-auth/AAecV5xZ-PnC_fKowQIAOCm2cbHyZKSdks5qq_urgaJpZM4J_l7r
    .

  9. Fishrock123 commented on Sep 17, 2016

    @Fishrock123
    Contributor

    FWIW, I think all of the people who have been doing releases are CTC members.

    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 master without a PR.

    Requiring a PR for that would just not work with how the release post tooling works here.

  10. cjihrig commented on Sep 17, 2016

    @cjihrig
    Contributor

    This isn't necessarily true, nor should it be.

    I agree, I was just stating the current reality in response to the comment that TSC/CTC signoff should be required.

  11. MylesBorins commented on Sep 17, 2016

    @MylesBorins
    Contributor

    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:

    This isn't necessarily true, nor should it be.

    I agree, I was just stating the current reality in response to the comment
    that TSC/CTC signoff should be required.

    —
    You are receiving this because you were mentioned.
    Reply to this email directly, view it on GitHub
    #8629 (comment), or mute
    the thread
    https://github.com/notifications/unsubscribe-auth/AAecV4d-dczoP201WkQsbFcP6nIb354Dks5qrCJpgaJpZM4J_l7r
    .

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    metaIssues and PRs related to the general management of the project.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions