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: make the documentation print-friendly #6748

Closed
wants to merge 1 commit into from
Closed

doc: make the documentation print-friendly #6748

wants to merge 1 commit into from

Conversation

sorcamarian
Copy link

@sorcamarian sorcamarian commented May 13, 2016

Checklist
  • tests and code linting passes
  • a test and/or benchmark is included
  • documentation is changed or added
  • the commit message follows commit guidelines
Affected core subsystem(s)
Description of change

@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label May 13, 2016
@Qard
Copy link
Member

Qard commented May 13, 2016

LGTM, but please add doc: to the start of the commit message.

@sorcamarian sorcamarian changed the title Make the documentation print-friendly doc: Make the documentation print-friendly May 13, 2016
@Qard
Copy link
Member

Qard commented May 13, 2016

Sorry, I meant the commit itself, not just the PR. You'll need to do a git commit --amend to edit the commit message, then force push the modified commit.

@MylesBorins
Copy link
Contributor

/cc @nodejs/website

@sorcamarian
Copy link
Author

@Qard I did --ammend, and --force push
Please make a check

image

overflow-y : auto;
}

}
Copy link
Member

Choose a reason for hiding this comment

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

Nit: missing newline at the end of file.

@sorcamarian
Copy link
Author

@ChALkeR I updated the commit.

margin-left: auto;
overflow-y: auto;
}
}
Copy link
Member

Choose a reason for hiding this comment

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

New line still missing here.

@lpinca
Copy link
Member

lpinca commented May 14, 2016

Please edit the commit message while you are at it: Make -> make.



@media print {
html {
Copy link
Member

@ChALkeR ChALkeR May 14, 2016

Choose a reason for hiding this comment

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

Replace

  html  {

with

  html {

as I noted above (one space between html and { instead of two).

@sorcamarian
Copy link
Author

White spaces removed.

@sorcamarian
Copy link
Author

Has something remained?

@addaleax
Copy link
Member

@sorcamarian I think this is good to go. Like @lpinca said in his last comment, the commit message subject should be all-lowercase, but things like this can be taken of when landing the commit.

If you’re asking why this isn’t merged yet, it’s just that it’s customary to wait a bit (72 hours over weekends is a general rule) before merging so that everyone has a chance to look at it.

I’d suggest you additionally use Fixes: https://github.com/nodejs/node/issues/6743 instead of the more info line, because then the issue will be closed automatically when your commit is landed.

Also: You author name in this commit is given as “Marian”. Is that intended or do you prefer to be listed (changelog, git log, AUTHORS file) with some other name? People typically prefer their full name, but ultimately it’s up to you.

@sorcamarian sorcamarian changed the title doc: Make the documentation print-friendly doc: make the documentation print-friendly May 16, 2016
@sorcamarian
Copy link
Author

@addaleax Thanks for the given explanations.

I'm fine with the current name("Marian").

@MylesBorins
Copy link
Contributor

LGTM... minor nits regarding newlines + commit message can be fixed when landing

Would like to hear something from more folks from @nodejs/documentation and @nodejs/website

@MylesBorins MylesBorins self-assigned this May 16, 2016
@lpinca
Copy link
Member

lpinca commented May 16, 2016

All nits seem to be fixed.

@addaleax
Copy link
Member

LGTM

@sorcamarian
Copy link
Author

Any news?

eljefedelrodeodeljefe pushed a commit that referenced this pull request May 23, 2016
Fixes: #6743

PR-URL: #6748
Reviewed-By: Robert Jefe Lindstaedt <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Stephen Belanger <[email protected]>
Reviewed-By: Myles Borins <[email protected]>
@eljefedelrodeodeljefe
Copy link
Contributor

Landed in c161849. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Node.js documentation is not print-friendly
9 participants