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.

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

doc: improve Download section of README #23212

Closed
wants to merge 4 commits into from

Conversation

Trott
Copy link
Member

@Trott Trott commented Oct 2, 2018

Simplify and clarify text in the Download section of the README file.

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

Simplify and clarify text in the Download section of the README file.
@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label Oct 2, 2018
@vsemozhetbyt vsemozhetbyt added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Oct 2, 2018
@refack
Copy link
Contributor

refack commented Oct 2, 2018

After this PR the section looks like:
image

Some of it seemed redundant to me, so I made a suggestion that looks like:
image

@refack refack removed the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Oct 2, 2018
README.md Outdated
documentation of the latest stable version.
<https://nodejs.org/api/>

Points to the API documentation of the latest LTS release.
Copy link
Member

Choose a reason for hiding this comment

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

This currently points to Node.js v10.11.0 docs, which is the latest current release, so I don't think it's correct to say it points to the latest LTS release.

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes. sorry.

README.md Outdated

Points to the API documentation of the latest LTS release.
Version specific documentation are avalible in each release and nightly
directory under _docs_.
Copy link
Member

Choose a reason for hiding this comment

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

Replace _docs_ with https://nodejs.org/download/docs/?

README.md Outdated
<https://nodejs.org/download/nightly/>

Release names are appeded a version string that includes the date (in UTC time)
and the 10 first characters of the commit SHA at the HEAD of the release.
Copy link
Member

Choose a reason for hiding this comment

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

Typo appeded -> appended with.

Copy link
Member

Choose a reason for hiding this comment

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

On reflection I think I prefer the original text. The reworded text is a little more awkward to read and adds more technical specifics for no added value.

Copy link
Contributor

Choose a reason for hiding this comment

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

Ack.

@Trott Trott added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Oct 2, 2018
@Trott
Copy link
Member Author

Trott commented Oct 4, 2018

Landed in cd40d7a

@Trott Trott closed this Oct 4, 2018
Trott added a commit to Trott/io.js that referenced this pull request Oct 4, 2018
Simplify and clarify text in the Download section of the README file.

PR-URL: nodejs#23212
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
targos pushed a commit that referenced this pull request Oct 4, 2018
Simplify and clarify text in the Download section of the README file.

PR-URL: #23212
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
jasnell pushed a commit that referenced this pull request Oct 17, 2018
Simplify and clarify text in the Download section of the README file.

PR-URL: #23212
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
@Trott Trott deleted the simplify-download branch January 13, 2022 22:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
author ready PRs that have at least one approval, no pending requests for changes, and a CI started. doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants