-
-
Notifications
You must be signed in to change notification settings - Fork 33.5k
Closed
Description
Over time, the docs have spread across many directory levels. I suggest they be moved around a bit to simplify the arrangement for consistency and discoverability.
Current state, edited to remove docs that are clearly in the right place (doc/changelogs, doc/api), with notes:
.
βββ BUILDING.md
βββ CHANGELOG.md
βββ CODE_OF_CONDUCT.md
βββ CONTRIBUTING.md
βββ GOVERNANCE.md
βββ README.md
βββ SECURITY.md
> Above are pretty traditional for project root dirs.
βββ COLLABORATOR_GUIDE.md
> Its a guide, move to doc/guides/. CONTRIBUTING is the top-level for people just starting
βββ CPP_STYLE_GUIDE.md
> Its a guide, move to doc/guides/.
βββ benchmark
βΒ Β βββ README.md
βΒ Β βββ writing-and-running-benchmarks.md
> Its a guide, move to doc/guides/writing-benchmarks, like doc/guides/writing-tests.md
βββ doc
βΒ Β βββ guides
βΒ Β βΒ Β βββ adding-new-napi-api.md
βΒ Β βΒ Β βββ backporting-to-release-lines.md
βΒ Β βΒ Β βββ building-node-with-ninja.md
βΒ Β βΒ Β βββ contributing
βΒ Β βΒ Β βΒ Β βββ coc.md
βΒ Β βΒ Β βΒ Β βββ issues.md
βΒ Β βΒ Β βΒ Β βββ pull-requests.md
> Perhaps there is a functional reason these three are here? Otherwise, coc.md seems like it should be CODE_OF_CONDUCT.md
βΒ Β βΒ Β βββ cve_management_process.md
βΒ Β βΒ Β βββ diagnostic-tooling-support-tiers.md
βΒ Β βΒ Β βββ internal
βΒ Β βΒ Β βΒ Β βββ readme.md
> Not clear why this is here on its lonesome, move to doc/guides/internal-api.md? or doc/api/internal.md?
βΒ Β βΒ Β βββ maintaining-icu.md
βΒ Β βΒ Β βββ maintaining-npm.md
βΒ Β βΒ Β βββ maintaining-the-build-files.md
βΒ Β βΒ Β βββ maintaining-V8.md
βΒ Β βΒ Β βββ node-postmortem-support.md
βΒ Β βΒ Β βββ security_release_process.md
> Move to security-release-process.md
βΒ Β βΒ Β βββ updating-root-certs.md
> Move to maintaining-root-certs.md
βΒ Β βΒ Β βββ using-internal-errors.md
βΒ Β βΒ Β βββ using-symbols.md
βΒ Β βΒ Β βββ writing-tests.md
.doc+
βΒ Β βββ offboarding.md
βΒ Β βββ onboarding-extras.md
βΒ Β βββ onboarding.md
βΒ Β βββ releases.md
> Move all 4 above to guides/? releases.md is here, security releases are in guides/, this is odd.
βΒ Β βββ STYLE_GUIDE.md
> Move to guides/documentation-style.md?
Also: we have randomly use both README.md
and readme.md
as file names, and should probably just use the uppercase version:
./benchmark/README.md
./README.md
./test/wasi/README.md
./test/fixtures/0-dns/README.md
./test/fixtures/wpt/url/README.md
./test/fixtures/wpt/resources/webidl2/README.md
./test/fixtures/wpt/resources/readme.md
./test/fixtures/wpt/README.md
./test/README.md
./test/wpt/README.md
./test/common/README.md
./doc/guides/internal/readme.md
./lib/internal/readme.md
./src/README.md
Metadata
Metadata
Assignees
Labels
No labels