镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content

doc: link to code style guide #12636

Description

@refack
  • Subsystem: doc

IMHO we should add a link to the Google Style Guide according to which me are linting C++
and add some Best Practices

After #12540 I thought we should add something like:


When editing C++

If you add a new macro or use a new external function, make sure you include the header file explicitly in the file you are editing. This makes sure your change is independent of previous changes, and makes it easier to backport

Activity

  1. added
    docIssues and PRs related to Node.js documentation.
    questionIssues asking questions about Node.js.
    on Apr 25, 2017
  2. gibfahn commented on Apr 25, 2017

    @gibfahn
    Member

    I think in general we try to document our coding style in lint rules. I don't know how easy it would be to lint for this.

  3. refack commented on Apr 25, 2017

    @refack
    ContributorAuthor

    Yeah I was thinking about that (linting for header include)

  4. refack commented on Apr 25, 2017

    @refack
    ContributorAuthor

    Still maybe we should have a style-guide to save new devs one "code" -> "lint" -> "fix" cycle

  5. gibfahn commented on Apr 25, 2017

    @gibfahn
    Member

    Still maybe we should have a style-guide to save new devs one "code" -> "lint" -> "fix" cycle

    The problem is that you then have to keep the style guide up to date with the linter. And I'm pretty sure the average dev would rather run the linter for each project than read the style guide, especially when you can just pass --fix to autofix basic issues.

  6. refack commented on Apr 25, 2017

    @refack
    ContributorAuthor

    So I've been reading cpplint.py, and was reminded nodejs/node-v0.x-archive#8487 that it actualy linting acording to https://google.github.io/styleguide/cppguide.html, so may be a link, and some rules of thumb?

  7. changed the title [-]doc: code style guide[/-] [+]doc: link to code style guide[/+] on Apr 25, 2017
  8. removed
    questionIssues asking questions about Node.js.
    on Apr 25, 2017
  9. refack commented on Apr 27, 2017

    @refack
    ContributorAuthor

    Ref: #11753

  10. Trott commented on Aug 4, 2017

    @Trott
    Member

    This should remain open? If so, maybe label help wanted?

  11. added
    help wantedIssues that need assistance from volunteers or PRs that need help to proceed.
    metaIssues and PRs related to the general management of the project.
    on Aug 12, 2017
  12. Divya063 commented on Oct 12, 2017

    @Divya063

    @refack I would like to work on this

  13. refack commented on Oct 12, 2017

    @refack
    ContributorAuthor

    @Divya063 there is already some work in progress to do that (#16090). Sorry I didn't update this issue.

  14. added
    wipIssues and PRs that are still a work in progress.
    and removed
    help wantedIssues that need assistance from volunteers or PRs that need help to proceed.
    on Oct 12, 2017
  15. Divya063 commented on Oct 12, 2017

    @Divya063

    @refack no problem. Is there other beginners-friendly issue on which I can work?

  16. Trott commented on Oct 12, 2017

    @Trott
    Member

    Hi, @Divya063! Take a look at http://nodetodo.org/getting-started/ for one way to get a good first task to work on in Node.js core.

  17. Divya063 commented on Oct 13, 2017

    @Divya063

    @Trott Thanks

  18. added a commit that references this issue on Oct 15, 2017
  19. added a commit that references this issue on Jul 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docIssues and PRs related to Node.js documentation.metaIssues and PRs related to the general management of the project.wipIssues and PRs that are still a work in progress.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions