Skip to content

[primer] rename Router/REED to Mesh Extender/Extender-Capable Device#200

Open
jwhui wants to merge 1 commit into
openthread:mainfrom
jwhui:mesh-extender
Open

[primer] rename Router/REED to Mesh Extender/Extender-Capable Device#200
jwhui wants to merge 1 commit into
openthread:mainfrom
jwhui:mesh-extender

Conversation

@jwhui

@jwhui jwhui commented Jun 12, 2026

Copy link
Copy Markdown
Member

Update the Thread Primer documentation to transition terminology from Router and Router Eligible End Device (REED) to Mesh Extender and Extender-Capable Device (ECD), respectively.

  • Rename "Router" to "Mesh Extender" (or "Active Mesh Extender" where referring specifically to the active parent role).
  • Rename REED (Router Eligible End Device) to Extender-Capable Device (ECD).
  • Rename "Router-Router links" to "Mesh Extender links".
  • Adjust roles, device types, addressing, and MLE attach descriptions to use the new terminology.
  • Fix grammatical errors and typos introduced during the transition.

@jwhui jwhui requested a review from EskoDijk June 12, 2026 19:19
gemini-code-assist[bot]

This comment was marked as outdated.

Comment thread site/en/guides/thread-primer/network-discovery.md Outdated
Comment thread site/en/guides/thread-primer/network-discovery.md Outdated
Comment thread site/en/guides/thread-primer/node-roles-and-types.md Outdated
Comment thread site/en/guides/thread-primer/node-roles-and-types.md Outdated
Comment thread site/en/guides/thread-primer/node-roles-and-types.md Outdated
Comment thread site/en/guides/thread-primer/node-roles-and-types.md Outdated
Comment thread site/en/guides/thread-primer/node-roles-and-types.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Comment thread site/en/guides/thread-primer/router-selection.md Outdated

@EskoDijk EskoDijk left a comment

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.

Overall I agree with the term changes and keeping "RLOC".
Comments are about specific improvements suggested, or issues found.

In general, images still mention REED and Router.

@jwhui jwhui force-pushed the mesh-extender branch 4 times, most recently from 9f1198d to 6cd24db Compare June 22, 2026 18:44
@jwhui jwhui requested a review from EskoDijk June 22, 2026 18:44
@jwhui jwhui marked this pull request as ready for review June 22, 2026 18:44
gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

@EskoDijk EskoDijk left a comment

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.

There are a couple of ot-primer-* figures (PNG) that still use the Router/REED terminology. My guess here is that we want to address all of these, in this PR, so that it covers the entire primer? If so: still to be converted.
(If not: maybe discuss why not)

@EskoDijk

EskoDijk commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Update: terminology was discussed in call 2026-07-01; leading to a new proposal (SPEC-1288).

@jwhui jwhui changed the title [primer] rename Router/REED to Active/Standby Mesh Extender [primer] rename Router/REED to Mesh Extender/Extender-Capable Device Jul 9, 2026
gemini-code-assist[bot]

This comment was marked as outdated.

@jwhui jwhui force-pushed the mesh-extender branch 2 times, most recently from 555255a to 125eb4b Compare July 9, 2026 17:50
gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

gemini-code-assist[bot]

This comment was marked as outdated.

@jwhui

jwhui commented Jul 9, 2026

Copy link
Copy Markdown
Member Author

/gemini review

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Code Review

This pull request updates the Thread primer documentation to transition from older terminology (such as 'Router' and 'REED') to newer terms like 'Mesh Extender' and 'Extender-Capable Device' (ECD). The review feedback focuses on ensuring precise and consistent application of this new terminology across diagrams, quiz options, and technical descriptions.

Comment thread site/en/guides/thread-primer/ipv6-addressing.md Outdated
Comment thread site/en/guides/thread-primer/network-discovery.md
Comment thread site/en/guides/thread-primer/router-selection.md
Comment thread site/en/guides/thread-primer/router-selection.md Outdated
Update the Thread Primer documentation to transition terminology from
Router and Router Eligible End Device (REED) to Mesh Extender and
Extender-Capable Device (ECD), respectively.

- Rename "Router" to "Mesh Extender" (or "Active Mesh Extender" where
  referring specifically to the active parent role).
- Rename REED (Router Eligible End Device) to Extender-Capable Device
  (ECD).
- Rename "Router-Router links" to "Mesh Extender links".
- Adjust roles, device types, addressing, and MLE attach descriptions
  to use the new terminology.
- Fix grammatical errors and typos introduced during the transition.
@jwhui

jwhui commented Jul 9, 2026

Copy link
Copy Markdown
Member Author

Update: terminology was discussed in call 2026-07-01; leading to a new proposal (SPEC-1288).

@EskoDijk , I updated this PR to reflect the latest consensus in SPEC-1288. Please review.

There are a couple of ot-primer-* figures (PNG) that still use the Router/REED terminology. My guess here is that we want to address all of these, in this PR, so that it covers the entire primer? If so: still to be converted.
(If not: maybe discuss why not)

I don't have access to the source files. We'll get these updated in a separate PR once we settle on the text changes (this PR).

@jwhui jwhui requested a review from EskoDijk July 9, 2026 18:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants