Software Engineering in WordPress and Musings on the Deep Life

An Update To The WordPress JavaScript Coding Standards

A few weeks ago, I published the first version of the WordPress JavaScript Coding Standards to the WordPress Codex. Since then, it’s already been updated with a variety of improvements from several other developers who are much more capable than I am.

However, there’s currently a major overhaul of certain documentation going on. For example, a number of us are working on the Core Contributor Handbook, the Theme Developer Handbook, the Plugin Developer Handbook, and more.

As of today, the WordPress JavaScript Coding Standards are now part of the Core Contributor Handbook.

WordPress JavaScript Coding Standards

Core Contributor Handbook

The WordPress JavaScript Coding Standards in the Core Contributor Handbook

So what does this mean from a reference standpoint? Generally speaking, nothing other than the fact that you’ll need to update your bookmarks (or favorites or whatever your browser calls them :).

If, however, you’re looking to contribute to the coding standards, there are now two ways in which you can get involved:

  1. If you’re sure of a change that you’d like to make, then you can use your WordPress.org login credentials. See Helen’s comment for more information.
  2. If, on the other hand, you have a general question or a point of discussion, please feel free to leave a comment on the article’s page.

Also, I’d like to thank Kim Parsell for migrating the documentation from the Codex to the new handbook, and I look forward to seeing the article continue to be refined.

Remember, the ultimate goal is for us to have a consistent standard by which we’re all writing our JavaScript, so let’s aim to make this document as comprehensive as possible.

9 Comments

  1. Helen H-S

    If, however, you’re looking to contribute to the coding standards, you’ll need to leave a comment on the article’s page.

    Not quite true – your WordPress.org login will work for the handbook and should automatically grant you the role of editor, essentially making it function as a wiki. Comments are good if you’re not sure, though. :)

    • Tom McFarlin

      Thanks for the clarification on this, Helen.

      When Kim and I were talking, she had mentioned taking the comment route so I wanted to make sure to promote that in the post.

      Given your comment, I’ll make sure to update the post, as well!

    • Kim Parsell

      I wasn’t aware of that Helen, so thank you for explaining the process. :)

  2. Russell Heimlich

    Nope. I logged in to the handbook and I don’t have the ability to edit it. What theme is the handbook using? I’m looking for something similar for internal documentation at work.

  3. Russell Heimlich

    It looks like it’s parsing the document and finding headlines to build the table of contents and add the anchor links.

    • Kim Parsell

      The Table of Contents in the left sidebar is nothing more than a custom menu, like Tom said. Pages are added manually, as they are completed. :) I’ll check on what needs to be done to get you access Russell.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

© 2023 Tom McFarlin

Theme by Anders NorenUp ↑