1204224 - Unclear explanation in "Working With Objects" tutorial

Status: RESOLVED WONTFIX

(Developer Documentation Graveyard :: JavaScript, defect, P3)

Description

[Mike McNally]

User Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:40.0) Gecko/20100101 Firefox/40.0
Build ID: 20150826185640

Steps to reproduce:

The page titled "Working with Objects" (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Working_with_Objects) has a section called "Using this for object references".  That section immediately follows a couple sections about defining prototype properties and defining methods.


Actual results:

 The "Using this" section deviates from the theme of examples in the prior sections, employing old-style event handling as the heart of its examples. No mention is made of the fact that the browser runtime environment is responsible for ensuring that "this" is set to refer to the DOM node when the handler is invoked. Even if that were mentioned, it's a jarringly strange way to present the topic in the context of most everything else in that tutorial.


Expected results:

Since the previous section discussed creating object methods, the "Using this" section (whose title should also be improved in the process) should discuss the use of "this" in methods invoked via object references. There's no need to bring the DOM into the discussion at all.

Comment 1

[sham.ibmgs]

Any update on this ticket?

Comment 2

[cartwr40]

Hi, I have added a new example which uses objects compared to DOM elements. I hope this is more helpful and like you wanted.
https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Working_with_Objects$compare?locale=en-US&to=1592602&from=1567021

Comment 3

[Janet Swisher]

:cmills - Does this look good to you?

Comment 4

[Chris Mills [:cmills]]

I'll let Florian review this (already ni'ed); this page is in the regular JavaScript Guide.

Comment 5

[BMO Automation]

MDN Web Docs' bug reporting has now moved to GitHub. From now on, please file content bugs at https://github.com/mdn/sprints/issues/ and platform bugs at https://github.com/mdn/kuma/issues/.