Skip to content

Conversation

@DavenportEmma
Copy link
Contributor

Improve markdown and documentation file organization.

Fixes: #31741

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • documentation is changed or added
  • commit message follows commit guidelines

Merged the CODE_OF_CONDUCT.md and doc/guides/contributing/coc.md
files into a single code of conduct file

Refs: nodejs#31741
Changed security_release_process.md to security-release-process.md
to stay consistent with file naming

Refs: nodejs#31741
Moved writing-and-running-benchmarks to doc/guides/ directory

Fixes: nodejs#31741
Updated updating-root-certs.md to maintaining-root-certs.md

Fixes: nodejs#31741
Moved COLLABORATOR_GUIDE, CPP_STYLE_GUIDE, and internal-api to
the appropriate directories

Fixes: nodejs#31741
Moved STYLE_GUIDE.md to guides/documentation-style.md

Fixes: nodejs#31741
Updated broken links after merging doc/guides/contributing/coc.md
@nodejs-github-bot nodejs-github-bot added the meta Issues and PRs related to the general management of the project. label Feb 13, 2020
Copy link
Member

@richardlau richardlau left a comment

Choose a reason for hiding this comment

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

A quick search for writing-and-running-benchmarks shows that the current location is referenced elsewhere so moving the file will break those links unless they are also updated.

The same applies to CPP_STYLE_GUIDE and COLLABORATOR_GUIDE.

tniessen and others added 15 commits February 13, 2020 21:12
PR-URL: nodejs#31719
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Anto Aravinth <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Add more information about why it is advisable not to use
`.FromJust()` etc. on Maybe(Local)s, and general information
about termination exceptions.

PR-URL: nodejs#31720
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Sam Roberts <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Moves directions for LTS release from the Release repo to Node docs.

Fixes: nodejs/Release#530
PR-URL: nodejs#31724
Reviewed-By: Richard Lau <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Myles Borins <[email protected]>
Reviewed-By: Beth Griggs <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Remove magic number and measure amount of difference should be allowable
between consecutive stat() calls.

PR-URL: nodejs#31726
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Two scenarios should be tested:

1. The completion is triggered and the result is printed before the
   next invocation.
2. The completion is triggered multiple times right after each other
   without waiting for the result. In that case only the last result
   should be printed.

The first scenario did not need a timeout while the latter did not
need a timeout for the second invocation.

PR-URL: nodejs#31708
Fixes: nodejs#31094
Reviewed-By: Denys Otrishko <[email protected]>
Reviewed-By: James M Snell <[email protected]>
PR-URL: nodejs#31705
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: David Carlier <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Anto Aravinth <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Was resolved in nodejs@e559842.

PR-URL: nodejs#31701
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
Reviewed-By: James M Snell <[email protected]>
PR-URL: nodejs#31692
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Trivikram Kamat <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Update my personal email address from [email protected] (tired)
to [email protected] (wired).

PR-URL: nodejs#31670
Reviewed-By: Richard Lau <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Anto Aravinth <[email protected]>
PR-URL: nodejs#31620
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Tobias Nießen <[email protected]>
Reviewed-By: James M Snell <[email protected]>
PR-URL: nodejs#31662
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: David Carlier <[email protected]>
Reviewed-By: Yuta Hiroto <[email protected]>
Reviewed-By: Gus Caplan <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
Add prerequisites for Arch Linux and derivatives in BUILDING.md.

PR-URL: nodejs#31669
Reviewed-By: David Carlier <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: James M Snell <[email protected]>
In benchmark directory this changes for loops
using var to let when it applies for consistency

PR-URL: nodejs#28958
Reviewed-By: Anna Henningsen <[email protected]>
Use `let` in module, napi, net, os, path, process, querystring, streams
and string_decoder.

PR-URL: nodejs#31592
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Anto Aravinth <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
nodejs@e559842
made writable/readable computed with a legacy mode if the properties
are written to.

LazyTransform still unecessarily wrote to these properties causing a
performance regression.

Fixes: nodejs#31739

PR-URL: nodejs#31742
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Benjamin Gruenbaum <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
@@ -1,4 +1,44 @@
# Code of Conduct
Copy link
Member

Choose a reason for hiding this comment

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

@conordavenport this one should be left as is, with the link over to the nodejs/admin repo

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oh right, thanks for pointing that out

PR-URL: nodejs#27517
Reviewed-By: Gireesh Punathil <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
@sam-github
Copy link
Contributor

I suggest all the guides be renamed to lower-case-with-minuses.md, it looks like two are still all-caps.

For every file that's renamed I suggest a git grep on its name because there are various TOCs and cross-links spread all over that link them together.

Thank you!

Trott and others added 2 commits February 13, 2020 22:21
Refs: nodejs#31727

PR-URL: nodejs#31728
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Denys Otrishko <[email protected]>
Reviewed-By: James M Snell <[email protected]>
There was an edge case where if _destroy calls the error callback
later than one tick the iterator would complete early and not
propgate the error.

PR-URL: nodejs#31314
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Minwoo Jung <[email protected]>
Reviewed-By: James M Snell <[email protected]>

PR-URL: nodejs#31700
Reviewed-By: Anna Henningsen <[email protected]>
Merged the CODE_OF_CONDUCT.md and doc/guides/contributing/coc.md
files into a single code of conduct file

Refs: nodejs#31741
Changed security_release_process.md to security-release-process.md
to stay consistent with file naming

Refs: nodejs#31741
Moved writing-and-running-benchmarks to doc/guides/ directory

Fixes: nodejs#31741
Updated updating-root-certs.md to maintaining-root-certs.md

Fixes: nodejs#31741
Moved COLLABORATOR_GUIDE, CPP_STYLE_GUIDE, and internal-api to
the appropriate directories

Fixes: nodejs#31741
Moved STYLE_GUIDE.md to guides/documentation-style.md

Fixes: nodejs#31741
Updated broken links after merging doc/guides/contributing/coc.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

meta Issues and PRs related to the general management of the project.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

doc/markdown file organization lacks coherence