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.

Sign up for GitHub

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

Jump to bottom

doc: add link to doc with social processes #45584

Closed
wants to merge 8 commits into from
Closed

doc: add link to doc with social processes #45584

Changes from 6 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
8cd63af
doc: add link to doc with social processes
mhdawson Nov 22, 2022
b65a3f7
Update doc/contributing/interacting-with-social.md
mhdawson Nov 22, 2022
81110d0
Update doc/contributing/interacting-with-social.md
mhdawson Nov 23, 2022
12749bd
Update doc/contributing/interacting-with-social.md
mhdawson Nov 23, 2022
a1dd571
Update doc/contributing/interacting-with-social.md
mhdawson Nov 23, 2022
4df54bb
Update doc/contributing/interacting-with-social.md
mhdawson Nov 23, 2022
a63f840
Update doc/contributing/interacting-with-social.md
mhdawson Nov 24, 2022
dbd50ce
squash: address comments
mhdawson Nov 24, 2022
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
6 changes: 6 additions & 0 deletions doc/contributing/interacting-with-social.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Interacting with social
Copy link
Member

Choose a reason for hiding this comment

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

"Interacting with social" is jargony. Most people don't translate "social" to "social media" much less "the social media team".

How about "Requesting social media posts" or something like that? (Same for the name of the file.)

Copy link
Member

Choose a reason for hiding this comment

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

Ooh, even better might be "Suggesting social media posts". @nodejs/social

Copy link
Member Author

Choose a reason for hiding this comment

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

Happy to change the any to any of those, or whatever based on any more feedback fom social team.

Copy link
Member Author

Choose a reason for hiding this comment

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

Maybe "Requesting social media posts or amplification" ?

Copy link
Member

Choose a reason for hiding this comment

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

I think "amplification" is still pretty jargony and makes it needlessly verbose, but I wouldn't block that. It's certainly more clear, I think, than "Interacting with social".

Copy link
Member Author

@mhdawson mhdawson Nov 23, 2022 •
edited
Loading

Choose a reason for hiding this comment

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

The title of the link that we got from the Foundation staff was Node.js Social Amplication Request Guidelines I could just use that minus the Node.js part which I think would be redundant.

Copy link
Member Author

@mhdawson mhdawson Nov 23, 2022 •
edited
Loading

Choose a reason for hiding this comment

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

To be specific social-amplification-request-guidelines.md

Copy link
Member

@Trott Trott Nov 24, 2022 •
edited
Loading

Choose a reason for hiding this comment

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

The title of the link that we got from the Foundation staff was Node.js Social Amplication Request Guidelines I could just use that minus the Node.js part which I think would be redundant.

You could, and I'm not going to block on this, but it's jargon. Jargon is OK for an internal document or a draft, but if we're publishing it widely, "social amplification" is a term likely to be unfamiliar to most readers. We should use terms that most people are likely to understand and that they might be searching for so they can find the right doc. If I were trying to find out how to get the nodejs Twitter account to retweet something, I might search for "social media" or "Twitter" or "posts" or "tweet", but I would be unlikely to search for "amplification" or "interacting with social".

I'm not going to block on this, though, because having a link to the process is vastly better than not having a link to the process, even if the document containing the link has a title that I think could be improved. So better that this land than I get things hung up on a word or two in the title.

Copy link
Member Author

Choose a reason for hiding this comment

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

@Trott , I really don't feel strong about it just thought leveraging language that the social team had used could make sense. I'll change to suggesting-social-media-posts.md


The management of the Node.js social media has been
delegated to OpenJS Foundation staff. The processes are
mhdawson marked this conversation as resolved.
Show resolved Hide resolved
documented in
[Node.js Social Amplification Request Guidelines](https://docs.google.com/document/d/1yrYZJ2twrbpUuScbo3rmN_v-Jfv6d2tO74nCT6PcpxI).