javascript-tutorial / javascript-tutorial/en.javascript.info

Some minor points of correction or clarification on the first Objects page

Open Beginner friendly
#3,859 7 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
25.5k
Forks
4k
PR merge metrics
No merged PRs in 30d

Description

https://javascript.info/object
There are 3 minor things on that excellent page that I noticed being not quite right.

1. The term "figure brackets" is extremely rare in English usage, most people use the term that is used on MDN, "curly braces". Of course I know what you mean, but that term isn't one of the 3 or even 4 most popular terms for those characters { } so it is better not to teach it to people.
2. In the file cabinet analogy, calling the files "signed" is odd. The most common terms that don't have weird connotations would probably be "labelled" or "marked".
3. While it may be true in most or even all popular implementations, you are definitely *not* supposed to presume the order shown of the elements getting presented to you in a (for el in obj) loop. Other ways of retrieving them, yes, but not by for el in obj.

Contributor guide

No contributing guide indexed for this repository

Research direction

Open https://javascript.info/object and review the three numbered points against the page’s current wording and JavaScript property-enumeration guidance. Update the relevant explanations and verify the page renders correctly; done when all three terminology and ordering concerns are addressed.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
62/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.