doc: make contributing info more discoverable

[mhdawson]

There are been several discussions in recent PRs about
the docs related to contributing not being very discoverable.
Move these docs from doc/guides/ to doc/contributing.

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

[mhdawson]

I think this is a step in the right direction although there may be other suggestions. If nothing else it can kickoff the bikeshedding.

[richardlau]

If we move these we'll also need to update any links, e.g. in https://github.com/nodejs/node/blob/master/CONTRIBUTING.md

[mhdawson]

I think I forgot to check in updates I made to fix a number of the lint issue :(

[mhdawson]

pushed commit to fix linter errors.

[mhdawson]

Will fix up things like the code owners once I see if people like/dislike the proposal

[mhdawson]

@Trott since you are active on docs. Want to get some level of agreement before I look at fixing up all the links in files not being moved.

I think those will just be the set identified in the linter failures reported. I guess my local run does not report those since they are in files not being changed.

[mhdawson]

Adding to tsc agenda to get some feedback on if this is a reasonable approach or not.

[Trott]

@Trott since you are active on docs. Want to get some level of agreement before I look at fixing up all the links in files not being moved.

At a high level, yes, I believe this is a sensible approach.

[jasnell]

+1 to this. Definitely think it's a good change!

[mmarchini]

In case anyone else was wondering, all docs from guides were moved to contributing (which makes sense IMO, since all docs there were related to contributing, maybe with the exception of build instructions).

@mhdawson I wouldn't be surprised if we have links in the org pointing to the coc file that was on doc/guides, worth double checking before landing.

[targos]

I think this means that the TSC will be pinged for changes to any of the guides now.

[mhdawson]

Thanks, good idea

[targos]

It was more of a comment/heads up. The previous directory structure and config only pinged TSC on a subset of documents.

[mhdawson]

If that becomes a problem I'm happy to change in later on.

[mhdawson]

Rebased and squashed and also looks like @targos fixed all of the links outside the docs I modified. Thanks!

[mhdawson]

Rerunning the test-asan once that passes I think the fact the the rest of the github actions are green likely means that links have been fixed up as well and this should be good to land. I'll do that once test-asan passes in order to avoid future conflicts which will happen every time there is a change to one of the maintaining docs.

I

[mhdawson]

Well test-asan failed again. Moving docs is not going to affect that and re-running an hour +1 job just to get an action to pass that does not test the change in the PR does not sound useful.

Going to land.

[mhdawson]

See this now has changed in code as well as docs, kicking off ci.

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/41968/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/41972/

[mhdawson]

Created 5 PRs to update links in other repos, will help to update others if we find ones that need to updated.

[ljharb]

re #41408 (comment), cool URLs don't change - can files be added in guides that point to the new locations?

[mhdawson]

re #41408 (comment), cool URLs don't change - can files be added in guides that point to the new locations?

I don't quite follow, the URLs are changing, I was submitting PRs to update to the new location?

[ljharb]

Right - i was referencing this core principle of the web which means that if a link moves, it's supposed to redirect, so that any link that's ever worked continues to work for eternity.

For in-repo docs this indeed may not always be practical, but for specific cases when a doc is known to be externally linked, it seems like a reasonable thing to do to me.

[mhdawson]

In this case the external links are in our own, or related repos so I think updating those thinks is probably the right thing to do versus keeing a redirect file forever.

[mhdawson]

Landed in a199387

[PETERO2022]

interesting and willing to learn more