Skip to content

Docs: Improve and clarify Promise terminology section#41566

Closed
amritamishra01 wants to merge 2 commits intomdn:mainfrom
amritamishra01:docs/improve-promise-terminology
Closed

Docs: Improve and clarify Promise terminology section#41566
amritamishra01 wants to merge 2 commits intomdn:mainfrom
amritamishra01:docs/improve-promise-terminology

Conversation

@amritamishra01
Copy link
Copy Markdown
Contributor

Description

This PR improves the "Promise terminology" section for better readability and clarity. The section has been restructured, and definitions have been simplified to be more accessible for learners.

Motivation

This change addresses a suggestion from a maintainer in issue #41538 to update the terminology section. The main goal is to resolve an inconsistency in the article by adding a definition for the term "completed" and explaining its relationship to "settled."

Related issues and pull requests

Fixes #41538

@amritamishra01 amritamishra01 requested a review from a team as a code owner October 16, 2025 18:32
@amritamishra01 amritamishra01 requested review from hamishwillee and removed request for a team October 16, 2025 18:32
@github-actions github-actions bot added Content:Learn Learning area docs size/s [PR only] 6-50 LoC changed labels Oct 16, 2025
## Promise terminology

Promises come with some quite specific terminology that it's worth getting clear about.
## Promise terminology
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD024/no-duplicate-heading Multiple headings with the same content [Context: "Promise terminology"]

@Josh-Cena
Copy link
Copy Markdown
Member

Duplicate of #41565

@Josh-Cena Josh-Cena marked this as a duplicate of #41565 Oct 16, 2025
@Josh-Cena Josh-Cena closed this Oct 16, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:Learn Learning area docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

An unclear sentence about promises

3 participants