Tag Archives: javascript

In Gutenberg#8602 it is raised if we should add support for an all action in wp.hooks in order to match feature parity with the current PHPPHP The web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher hooks system in WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.. While there were no real objections raised in the chat, pretty much everyone present agreed with this comment:

If it is primarily intended for debugging, then it might be worth exploring optimizations to avoid any impact in typical usage, e.g. monkey-patching runHooks when an all hook is added.
@aduth

Actions

No interest was expressed in the issue. If anyone wants to take it on, there wouldn’t be any objections either.

Agenda: Ways to optimize the package updating process

The process for updating packages needs to be optimized further. Right now any fix on a package has to follows the cumbersome flow of GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ PR -> lerna release -> core ticketticket Created for both bug reports and feature development on the bug tracker. -> update package.jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. -> commit. We need to make this smoother.

This problem would probably not exist once everything is merged into a single monorepo hosted on git. But that doesn’t seem feasible just yet. Could we maybe mimic the advantage of having a monorepo a bit by getting more tooling into WordPress core and build straight from GithubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. https://github.com/ source? That would at least decouple publication of packages from being able to consume their changes in WordPress core development.

It was raised by @gziolo that installing Gutenberg straight from Github with npm is not an option because Gutenberg consumes local packages which can’t be resolved by npm. The solution proposed is to take a similar approach to how Gutenberg packages are updated for Drupal.

This is done with an install script that simply clones Gutenberg into node_modules and builds the scripts in Gutenberg itself. While not a very elegant solution, this could work and drastically improve the process of keeping the packages updated.

Actions

@atimmer will work on a proof of concept.

Open floor: JSJS JavaScript, a web scripting language typically executed in the browser. Often used for advanced user interfaces and behaviors. i18ni18n Internationalization, or the act of writing and preparing code to be fully translatable into other languages. Also see localization. Often written with a lowercase i so it is not confused with a lowercase L or the numeral 1. Often an acquired skill.

Good progress is being made on JavaScript language packs. 🎉 @herregroen is working together closely with @nerrad, @swissspidy and @ocean90 to land this. There seems to be a great deal of consensus and the work is nearing completion.

#corejs, #javascript

Darren Ethier (nerrad) 2:46 pm on October 16, 2018
Tags: javascript

Javascript Chat Summary – October 16, 2018

Have a topic for discussion for the next meeting? Leave a suggested edit on next week’s agenda.

Agenda: “Props” for GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ Merge

How are props being handled for the merge of Gutenberg code?

consensus was mostly reached on GithubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. https://github.com/ profile attribution for any involved in a pull request.
There were not concrete plans for technical process implementation of props yet.

Actions

Discussion can continue in the meeting notes, or revisited in a future meeting.

Agenda: “Internationalization”

Proposal for language packs
for v1, utilize `wp_localize_script` for loading/queuing translations.
for v1, generate translationtranslation The process (or result) of changing text, words, and display formatting to support another language. Also see localization, internationalization. file (po,mo,jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML.…) for every single JSJS JavaScript, a web scripting language typically executed in the browser. Often used for advanced user interfaces and behaviors. file

Actions

split this out into a metaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. tracTrac An open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress. ticketticket Created for both bug reports and feature development on the bug tracker. and create tickets/issues on different projects as necessary. (owned by @herregroen)

Agenda: PluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party. and BlockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. Scaffolding

There are some recently released projects designed to aid developer experience around plugins and blocks for Gutenberg:

https://github.com/youknowriad/wp-js-plugin-starter
Work also started on a solution based on the above which is purely JS based.

Action:

continue feedback/evaluation on the pull request

Agenda: Pending bump of Node’s LTS version from 8.x to 10.x

Slack Conversation | Context

Action:

probably only request a bumping of the relevant files with node version in them.
possibly some docs updating needed.
revisit in a following meeting.

Riad Benguella 3:48 pm on October 10, 2018
Tags: corejs ( 8 ), javascript

JavaScript Chat Summary – October 9th

Have a topic for discussion for the next meeting? Leave a suggested edit on next week’s agenda.

Preparing for WordPress 5.0

The technical overview of the Gutenberg integration into Core post has been shared.
Integration of the GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ packages as npm dependencies into CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. has started (Core ticket, Github PR for review).
Remaining work to ensure all the Gutenberg JavaScript is available as packages, has landed. Publishing the packages to npm should happen as soon as the 4.0 RCrelease candidate One of the final stages in the version release cycle, this version signals the potential to be a final release to the public. Also see alpha (beta). of Gutenberg is released.

Action items

Continue the packages integration work: @atimmer @gziolo @youknowriad
Nice to have: Work on an ESlint WordPress preset package and integrate into Core. @netweb

Annotations APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. in Gutenberg

The foundation work will be shipped in 4.0: The RichText package and the RichText structure.
A custom format API will be added. Likely for 4.1.
The annotations API should be built on top of this custom format API.

Action items

Continue the work on the custom format API targeted for 4.1: @iseulde
Coordinate with the Annotations API PR: @atimmer @iseulde

Generic Data Store API

The Data Module of Gutenberg is composed of two parts:

The Producer API: Registering stores, selectors, actions.
The Consumer API: Consuming selectors and actions in components and other scripts.

@coderkevin proposed to make the producer API less opinionated allowing custom stores implementations to leverage advanced use-cases for big applications/plugins like Calypso or WooCommerce while ensuring backward compatibility for the current implementation.

No blockerblocker A bug which is so severe that it blocks a release. was raised on the Core side and the work should continue on the proposed PR.

Action items

Review and improvements to the PR. @coderkevin @youknowriad

#corejs, #javascript

Greg Ziółkowski 12:39 pm on September 26, 2018
Tags: core-js ( 131 ), javascript

JavaScript Chat Summary – September 25th

Have a topic for discussion for the next meeting? Leave a suggested edit on next week’s agenda.

Packages

ShortcodeShortcode A shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site. in CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.

@youknowriad proposed a pretty exciting change which would allow to consume the existing @wordpress/shortcode npm packge in WordPress core. It’s ready for testing and gathering feedback.

Issue: https://core.trac.wordpress.org/ticket/44987

Once it lands in core, it will enable further integrations with the packages like @wordpress/a11y, @wordpress/api-request, @wordpress/wordcount, etc. This is going to pave the way to integrate GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ in core.

Call for npm maintainers

We have only 6 team members which are able to publish updated npm packges to npm. We would love to extend this group to have more flexibility and better coverage when people take time off.

We also discussed that we should start publishing updates to packages on regular basis like once a week. Preferably before the weekly JSJS JavaScript, a web scripting language typically executed in the browser. Often used for advanced user interfaces and behaviors. chat.

@noisysocks volunteered to help with the upcoming release 🎉 Let us know if you are willing to join the group.

Open Floor

Update on Mobile Gutenberg

Kudos to @hypest for adding tests for Mobile Gutenberg in Gutenberg’s Continues Integration job. This is the first step towards merging those two repositories together and bring their development process even closer. It will help us prevent introducing changes which would break the mobile project.

#javascript #core-js

Jeffrey Paul 4:34 pm on September 20, 2018
Tags: 4.9.9 ( 11 ), accessibility ( 59 ), core ( 746 ), core-editor ( 757 ), core-https ( 2 ), core-js ( 131 ), core-restapi ( 34 ), dev chat ( 923 ), gutenberg ( 547 ), javascript, summary ( 976 )

Dev Chat Summary: September 19th (4.9.9 week 6)

This post summarizes the dev chat meeting from September 19th (agenda, Slack archive).

4.9.9 planning

@westonruter: highlighted this discussion about the scope of HTTPSHTTPS HTTPS is an acronym for Hyper Text Transfer Protocol Secure. HTTPS is the secure version of HTTP, the protocol over which data is sent between your browser and the website that you are connected to. The 'S' at the end of HTTPS stands for 'Secure'. It means all communications between your browser and the website are encrypted. This is especially helpful for protecting sensitive data like banking information. support to target in 4.9.9
- Looking for wider visibility on those items to get thoughts on what makes sense to include in 4.9.9
- Relates to umbrella ticketticket Created for both bug reports and feature development on the bug tracker. #28521
@audrasjb: AccessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) team has a spreadsheet where we sort all the tickets on the focus a11yAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) in order to facilitate lead’s work (see this week’s meeting notes)
Bug scrubs not scheduled yet, when they are it’ll be posted to Make/CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.

Updates from focus leads and component maintainers

@kadamwhite from the REST APIREST API The REST API is an acronym for the RESTful Application Program Interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. It is how the front end of an application (think “phone app” or “website”) can communicate with the data store (think “database” or “file system”) https://developer.wordpress.org/rest-api/ team wants to propose the inclusion #41305 in 5.0
- This covers altering how we evaluate translationtranslation The process (or result) of changing text, words, and display formatting to support another language. Also see localization, internationalization. strings, originally with the intent of deliberating a performance improvement to the REST API. In discussions about how LocaleLocale A locale is a combination of language and regional dialect. Usually locales correspond to countries, as is the case with Portuguese (Portugal) and Portuguese (Brazil). Other examples of locales include Canadian English and U.S. English. can be applied to REST API responses for GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ this issue resurfaced, because the current order of operations precludes evaluating string translations based on a passed flag (required to permit the APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. to provide translations in a user’s locale). To support these localization needs and to improve overall performance at the same time, we intend to milestone this ticket for 5.0.
- @schlessera: There are two proposed solutions in the above ticket: one that fixes REST API schema translations only, and one that generally optimizes translations (REST API component team’s strong recommendation). The latter is highly preferable, but includes breaking changes for edge cases (as noted in the ticket), so might need a check against plugins first. We otherwise would like more eyes on the forthcoming patchpatch A special text file that describes changes to code, by identifying the files and lines which are added, removed, and altered. It may also be referred to as a diff. A patch can be applied to a codebase for testing. to validate the approach and to help test it.
The Editor / Gutenberg team released v3.8 last week including “full screen” mode, improved mechanisms for styling blocks from a theme perspective, and exposes the custom post typeCustom Post Type WordPress can hold and display many different types of content. A single item of such a content is generally called a post, although post is also a specific post type. Custom Post Types gives your site the ability to have templated posts, to simplify the concept. used to store reusable blocks from the blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. inserter as a way to manage saved blocks in bulk.
The JavaScriptJavaScript JavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com team published notes from their last meeting including documentation of available Gutenberg scripts, reducing exposure of Moment.js in the `wordpress/date` module, and a couple announcements on introducing a formal asynchronous data flow as part of `wordpress/data` and the new `wp-polyfill` script added to Gutenberg.

General announcements

@psykro posted about alternate devchat options. Please give that a review and feedback, as ideally we get to a conclusion during next week’s devchat.
@whitneyyadrich & @dkotter looking for eyes on / update to Gutenberg issue#7762 as they are running into an issue where they need to be able to insert and manipulate media attachments within the Classic Block, but that’s not currently possible
- Also imagine this being a bigger issue when migrating sites over to Gutenberg and all their existing content will be thrown into that block. There’s currently not a great way for them to modify/add to that content, if they need to do things with images.
- Will review with Gutenberg team in next #core-editor weekly chat

Next meeting

The next meeting will take place on September 26, 2018 at 20:00 UTC in the #core SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/ channel. Please feel free to drop in with any updates or questions. If you have items to discuss but cannot make the meeting, please leave a comment on this post so that we can take them into account.

#4-9-9, #accessibility, #core, #core-editor, #core-https, #core-js, #core-restapi, #dev-chat, #gutenberg, #javascript, #summary

Andrew Duthie 7:39 pm on September 18, 2018
Tags: javascript

JavaScript Chat Summary – September 18th

Have a topic for discussion for the next meeting? Leave a suggested edit on next week’s agenda.

Announcements

Work toward introducing a formal asynchronous data flow as part of the @wordpress/data continues, with the introduction of support for generator controls in resolvers.
Following-up on discussions from last week’s meeting, a new wp-polyfill script has been added to Gutenberg, the goal of which to serve as a single dependency which any pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party. seeking support for either new language features or browser functionality can leverage.

Open Floor

Documentation of Available GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ Scripts

Gutenberg registers a number of scripts, but an exhaustive set of all scripts isn’t available, nor is it well-documented how these scripts can be used by a plugin.

Decision: Create new documentation to be included in the “Reference” section of the Gutenberg Handbook, detailing which script handles are available for plugin authors to reference.

Issue: https://github.com/WordPress/gutenberg/issues/10005

Reducing Exposure of Moment.js in the `@wordpress/date` module

Our @wordpress/date module uses the popular Moment.js library to implement date formatting. We should be conscious of the long-term maintenance burden in committing this into our public APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways., particularly in light of alternative date formatting offerings and future maintenance likelihood of Moment.js.

Decision: We’ll continue to use Moment.js for the immediate future, but we should eliminate its availability from the public interface.

Issue: https://github.com/WordPress/gutenberg/issues/10007

Future Action Items:

Gain a better understanding of the requirements of our public interface by auditing existing usage, understanding server-imposed restrictions (site formatting as an option), and knowledge transfer from equivalent WordPress PHPPHP The web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher APIs (strive for seamless transition)
Explore alternative offerings to Moment.js

Related Resources:

Anton Timmermans 10:31 am on June 14, 2018
Tags: core ( 746 ), core-js ( 131 ), inline-docs ( 13 ), javascript, xxxxx ( 3 )

JS docs initiative: Add inline-docs for JavaScript! (part 2)

Because of a restriction of wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/, you cannot comment on posts older than 120 days. This new post can be used to track the work on JavascriptJavaScript JavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com inline-docs. The original post on the JS docs initiative can be found here. In this post I have excluded files that have already been completed.

At the bottom is a list of every first-party JavaScript file in coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.. Files with a checkmark have been patched and are considered completed. Files marked with (username #xxxxx) are already claimed, and being worked on.

Directly below is the process we’re using to make sure each of these files can get patched swiftly with no duplicated nor wasted efforts.

How to contribute

Familiarize yourself with the JavaScript documentation standard, as well as the formatting guidelines and documenting tips.
Check the list first to make sure the file you want to work on hasn’t already been claimed.
Update your local WordPress SVN (use svn up) or Git repo (use git pull) to the latest version of WordPress trunktrunk A directory in Subversion containing the latest development code in preparation for the next major release cycle. If you are running "trunk", then you are on the latest revision..
Create a new ticket on Trac for the file.
- Format the title as “JSDoc: path/to/file.js”.
- The Type should be “defect (bugbug A bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority.)”.
- Assign the ticketticket Created for both bug reports and feature development on the bug tracker. to the component the file is associated with.
- Leave the Version blank.
- Add the docs and javascript focuses.
Edit the file, and make a patchpatch A special text file that describes changes to code, by identifying the files and lines which are added, removed, and altered. It may also be referred to as a diff. A patch can be applied to a codebase for testing.. Please make sure you create the patch from the root directory of your WordPress SVNSVN Subversion, the popular version control system (VCS) by the Apache project, used by WordPress to manage changes to its codebase. or GitGit Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Git is easy to learn and has a tiny footprint with lightning fast performance. Most modern plugin and theme development is being done with this version control system. https://git-scm.com/ checkout.
Upload your patch to the TracTrac An open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress. ticket you created, and add the keyword “has-patch”.

We’d like to welcome everyone to start contributing inline documentation! You can start contributing by picking a file from the list of unclaimed files below and claiming it in the comments. Please also see the JSJS JavaScript, a web scripting language typically executed in the browser. Often used for advanced user interfaces and behaviors. docs handbook page for a step by step guide on how to get started.

Note: To give everyone a chance to claim a file and to ensure the work proceeds as quickly as possible, please only work on one file at a time.

Determining the since version

The recommended tool to use when searching for the version something was added to WordPress is svn blame. An additional resource for hooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. is the WordPress Hooks Database. If, after using these tools, the version number cannot be determined, use @since Unknown.

If you use the git repository of WordPress you can also use git to determine the @since version. Either use git blame or the GitHub blame function. Once you have the commit hash which introduced a piece of code you can find out the version by using git tag --contains [commit-hash]. This will list all versions a certain commit has been shipped in. The lowest version is then what you put after the @since annotation.

Note: Make sure that the commit you found it the actual commit where a piece of code was introduced. JavaScript files have been moved around a lot in the past, so make sure to take that into account.

Note: All @since tags should follow the three digit x.x.x format.

Keeping Discussions Focused:

Any discussion about the specifics of a patch itself should happen on Trac. Any discussion about the broader scope of what we’re trying to do should take place during the weekly devchat. That’s either #core-js or #core.

Files needing patches:

Checked files are completed, marked files are claimed

Current status:

Total: 178 files
Completed: 50 files (28%)
In progress: 7 files
Available to claim: 121 files

Happy documenting!

#inline-docs

Anton Timmermans 10:45 pm on January 31, 2018
Tags: core ( 746 ), core-js ( 131 ), inline-docs ( 13 ), javascript, xxxxx ( 3 )

JS docs initiative: Add inline-docs for JavaScript!

There is a new post which you can comment on to claim files. We are pleased to announce the JS docs initiative! It’s an ongoing effort to get all JavaScriptJavaScript JavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com files in WordPress well-documented and make this documentation easily accessible. JavaScript development within WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. is speeding up fast, and better documentation will help this work progress as smoothly as possible. In the last few months, we’ve fixed the JavaScript documentation standards by discussing sticking points in the #core-js weekly meeting. The structural documentation of all the Backbone classes has also been fixed (major props to @herregroen for fixing this). At the bottom is a list of every first-party JavaScript file in core. Files with a checkmark have been patched and are considered completed. Files marked with (username #xxxxx) are already claimed, and being worked on. Directly below is the process we’re using to make sure each of these files can get patched swiftly with no duplicated nor wasted efforts.

How to contribute

Familiarize yourself with the JavaScript documentation standard, as well as the formatting guidelines and documenting tips.
Check the list first to make sure the file you want to work on hasn’t already been claimed.
Update your local WordPress SVN (use svn up) or Git repo (use git pull) to the latest version of WordPress trunktrunk A directory in Subversion containing the latest development code in preparation for the next major release cycle. If you are running "trunk", then you are on the latest revision..
Create a new ticket on Trac for the file.
- Format the title as “JSDoc: path/to/file.js”.
- The Type should be “defect (bugbug A bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority.)”.
- Assign the ticketticket Created for both bug reports and feature development on the bug tracker. to the component the file is associated with.
- Leave the Version blank.
- Add the docs and javascript focuses.
Edit the file, and make a patchpatch A special text file that describes changes to code, by identifying the files and lines which are added, removed, and altered. It may also be referred to as a diff. A patch can be applied to a codebase for testing.. Please make sure you create the patch from the root directory of your WordPress SVNSVN Subversion, the popular version control system (VCS) by the Apache project, used by WordPress to manage changes to its codebase. or GitGit Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Git is easy to learn and has a tiny footprint with lightning fast performance. Most modern plugin and theme development is being done with this version control system. https://git-scm.com/ checkout.
Upload your patch to the TracTrac An open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress. ticket you created, and add the keyword “has-patch”.

Note: To give everyone a chance to claim a file and to ensure the work proceeds as quickly as possible, please only work on one file at a time.

Determining the since version

We use JSDoc’s @since tagtag A directory in Subversion. WordPress uses tags to store a single snapshot of a version (3.6, 3.6.1, etc.), the common convention of tags in version control systems. (Not to be confused with post tags.) to indicate when a particular function was added to WordPress core. When you are documenting a function, you will also need to identify when that function was first introduced. The recommended tool to use when searching for the version something was added to WordPress is svn blame. An additional resource for hooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. is the WordPress Hooks Database. If, after using these tools, the version number cannot be determined, use @since Unknown. If you use the git repository of WordPress you can also use git to determine the @since version. Either use git blame or the GitHub blame function. Once you have the commit hash which introduced a piece of code you can find out the version by using git tag --contains [commit-hash]. This will list all versions a certain commit has been shipped in. The lowest version is then what you put after the @since annotation. Note: Make sure that the commit you found it the actual commit where a piece of code was introduced. JavaScript files have been moved around a lot in the past, so make sure to take that into account. Note: All @since tags should follow the three digit x.x.x format.

Keeping Discussions Focused:

Files needing patches:

Checked files are completed, marked files are claimed Current status:

Total: 181 files
Completed: 45 files (24.9%)
In progress: 3 files
Available to claim: 133 files

Happy documenting! #inline-docs #javascript

Andrew Duthie 4:48 pm on December 4, 2017
Tags: javascript

JavaScript Chat Canceled for December 5th

Due to conflicting travel arrangements of some participants following this past weekend’s WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. US, we will be canceling the JavaScriptJavaScript JavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com Chat for this week. The next meeting will resume as regularly scheduled on Tuesday, December 12, 2017 at 14:00 UTC.

Andrew Duthie 5:20 pm on November 13, 2017
Tags: javascript

Core JavaScript Meeting Time Change

In response to feedback collected during and after last week’s JavaScriptJavaScript JavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com chat, the scheduled time of these meetings has been changed to occur one hour later, starting tomorrow at Tuesday, November 14, 2017 at 14:00 UTC and at the same time each Tuesday thereafter.

A few respondents had indicated preference for an Asia/Pacific-friendly meeting time. If enough interest can be generated, a separate meeting may be justifiable. Please indicate in the comments below if you would have interest in regularly attending at a time convenient for this region.