Josh's summer MDN projects

[Josh-Cena]

Below is a dump of all projects I have the will to complete this summer from June to August (review is appreciated for each PR). This issue is to sync my todo list with the team and the community to avoid duplicated work and let people know what I may be focusing on—I will avoid creating issues for each one of them. Items are sorted by decreasing priority, and the ones down the list may depend on items above:

• Regex v flag documentation (stage 4; top priority!)
  • Reference for stage 4 regexp-v-flag #26944
• Update the let/var/const pages, in preparation for explicit-resource-management
  • Create new binding glossary, streamline all declaration reference pages #26973
• Exhaustively document Date objects' primitive representations and the date string format usage, in preparation for temporal
  • Avoid using non-standard date string format, better date string description #27005
• Align all toString()/valueOf()/[@@toPrimitive]() pages
• Document generator functions' and generator objects' prototype chains, in preparation for iterator-helpers
  • Note: this one is done, but I'm not sending the PR pending https://github.com/orgs/mdn/discussions/358 (or when I really feel necessary)
• Make all TypedArray methods link to the array counterpart as the source of truth
  • Remove all extra explanation of TypedArray methds and redirect to Array methods #28394
• Consistently mention Unicode code points and UTF-16 code units in string methods
  • Improve description for string methods that deal with code points #27545
• Align all Intl APIs' supportedLocalesOf() and resolvedOptions() methods; investigate more consistency for other methods as well
  • Align the structure of all supportedLocalesOf pages #28525
  • Normalize Intl constructor options representation #28594
• Brief guide for all Intl APIs
• Make the typed array guide more like an actual guide, with mentions of use cases and memory representation
  • Add more content to the typed arrays guide #28628
• Split the modules guide into two parts: "JavaScript modules" and "JavaScript modules on the web", in preparation for many new module features to come
• Audit the JS guide; make sure all interesting features are introduced in the guide
• Make the errors reference more exhaustive and remove non-standard and/or outdated errors; investigate linking to these errors from API "Exceptions" section (instead of linking to the error global)
• Use a consistent format for API intro paragraphs
  • Array/String: make instance methods mention its related class #28456
• Investigate syncing API main pages' dl content with each subpage's description (may not be an improvement over status quo)
• Preliminary docs for big unshipped stage-3 features (explicit-resource-management, iterator-helpers, set-methods); look forward to some of them shipping this summer
  • Reference for stage 3 arraybuffer-transfer #28381
  • Reference for stage 3 duplicate-named-capturing-groups #28407
  • Reference for stage 3 set-methods #28414
  • Reference for (new) stage 3 array-grouping #28424
  • Reference for stage 3 iterator-helpers #28677
  • TODOs: explicit-resource-management, shadowrealm, decorators, decorator-metadata, json-parse-with-source, regexp-modifiers, float16array, promise-with-resolvers
• Update all pages' see also section to use the new guidelines; consistently mention relevant guides and main API reference pages
  • Make see also match guidelines #28668
  • Align see also item text with target title #28799
• Upgrade the "closures" page to talk everything about scopes and declarations

Of course, other issues will be worked on as I receive them, others' PRs will be reviewed by me, and more casual PRs will be sent when I feel necessary.

[postmeback]

Is there any way, I can help you on this summer internship ?

[Josh-Cena]

@postmeback Thanks for your interest, but these are marked as my work—most of these are establishing editorial conventions so they are hard to delegate to external contributors. Also to clarify: this is not a summer internship; it's just because I'm too busy during the school term and just got more time during the break :)

[postmeback]

@Josh-Cena , thanks for the update. Hopefully, you can accomplish all the given task within time.

[chrisdavidmills]

@Josh-Cena Just as an FYI Josh (as I know you are deep into this stuff) — I was intending to start documenting JS iterator helpers very soon, and I just wanted to check that I wouldn't be overlapping with any work you are doing.

[Josh-Cena]

#28677

[Josh-Cena]

My summer has ended, so I'm closing this. I ended up finishing/near-finishing more than half of them, but because I spent most of the summer enjoying myself, the list is not all checked. I will continue to work on these when I have the time. My most significant effort this summer has been my https://github.com/jc-verse/mdn-checker project, which helped me make many of the refactoring PRs.

[hamishwillee]

@Josh-Cena - I can't believe you enjoyed your summer and still did all this. Thanks very very much.

[bsmth]

@Josh-Cena - I can't believe you enjoyed your summer and still did all this. Thanks very very much.

Ditto, well done on these improvements - thank you!

[Josh-Cena]

Thanks! Working on open source is part of the process of enjoying myself as well 😀