doc: move streaming instructions to doc/contributing

[mhdawson]

• make streaming instructions more discoverable by moving them from the TSC repo to doc/contributing
• upate the instructions to reflect current practice

Signed-off-by: Michael Dawson [email protected]

[nodejs-github-bot]

Review requested:

• @nodejs/tsc

[mhdawson]

I'l remove the copy in the TSC repo once this lands.

[richardlau]

• make streaming instructions more discoverable by moving them from the TSC repo to doc/contributing

It doesn't really feel like these belong here though. Most contributors will not be streaming on the project's accounts (nor have access to do so).

[mhdawson]

@richardlau the leads for the teams are the people that I've been most recently sharing with. I guess they are not necessarily in core, but I thought this would be more discoverable that anywhere else we have.

[richardlau]

If discovery is the issue, perhaps a link could be added to the meeting templates for the meeting hosts?

[mhdawson]

@richardlau I'm not sure I understand what you mean by:

If discovery is the issue, perhaps a link could be added to the meeting templates for the meeting hosts?

do you mean add a link to the meeting templates in this doc and a section about setting up the meeting generation?

[richardlau]

@richardlau I'm not sure I understand what you mean by:

If discovery is the issue, perhaps a link could be added to the meeting templates for the meeting hosts?

do you mean add a link to the meeting templates in this doc and a section about setting up the meeting generation?

I mean the meeting templates could contain a section for meeting hosts that points to the doc in the TSC repo. That way every generated meeting issue would contain a link to the streaming instructions.

[mhdawson]

I mean the meeting templates could contain a section for meeting hosts that points to the doc in the TSC repo. That way every generated meeting issue would contain a link to the streaming instructions.

I'm not sure if that would have helped in the recent cases where I shared the info. I guess it's also not necessarily directly related to where the doc is as it would still need to be somewhere for the link to point to. I don't think the TSC repo is the right place which is why I was moving it.

If you don't think docs/contributing is the right place where do you think it should be?

[richardlau]

I don't think the TSC repo is the right place which is why I was moving it.

If you don't think docs/contributing is the right place where do you think it should be?

I think the TSC repo is a better fit for the streaming instructions than the core nodejs/node repo. If not the TSC repo, maybe https://github.com/nodejs/admin since that's where you need to open an issue to request access?

[mhdawson]

I don't think people go looking in the TSC repo or the admin repo info like this, but if others disagree I'll close the PR. Going to leave this open for a bit to see if we get others chiming in as well.

[richardlau]

While I don't think this repository is the place for the streaming instructions, I do not feel strongly enough about this to block PR from landing if there is otherwise consensus.

[Trott]

I agree with Richard that this is not the repository for these instructions, but I'm not readily coming up with a better place. If we still had a wiki on this repo, that might be OK. Maybe the thing to do is leave the instructions where they are but add a doc here that links to it?

Like Richard, I don't care enough to block this, so this can certainly land. It does feel like it's a misuse of the repository, though.

(I think we turned off the wiki because it was world-writable and nobody was paying attention to it and bad stuff was happening there. However, I'm pretty sure you can enable a wiki with write access for collaborators only. So maybe this is an indication that we should do that. I think there are a lot of things that would be better placed in the wiki, such as the onboarding/offboarding documentation, the glossary file, and probably everything or nearly everything under doc/contributing as long as we put a prominent link in the README and CONTRIBUTING.md.)

[gireeshpunathil]

I see already documents in this folder which are relevant only to a subset of contributors: collaborator guide, offboarding, security on/off boarding etc. In the absence of a better place for this, and not seeing any downside of having this info here, I am good with its location.

[mhdawson]

Landed in f2c4fe9