Skip to content

docs: fix wording for Script and Plugin compatibility#13012

Open
andrewbytecoder wants to merge 2 commits intoapache:masterfrom
andrewbytecoder:patch-2
Open

docs: fix wording for Script and Plugin compatibility#13012
andrewbytecoder wants to merge 2 commits intoapache:masterfrom
andrewbytecoder:patch-2

Conversation

@andrewbytecoder
Copy link

This PR fixes a minor but potentially confusing typo in docs/en/latest/script.md (and its Chinese counterpart if applicable), where the terms "Script" and "Plugin" were incorrectly used interchangeably or mislabeled in a sentence describing APISIX's extension mechanisms.

In Apache APISIX, Scripts and Plugins are distinct concepts:
Plugins are reusable, configurable modules that hook into the request lifecycle (e.g., key-auth, limit-req).
Scripts refer to inline Lua logic attached directly to a Route (or Service) for custom, route-specific behavior.

The original wording blurred this distinction, which could mislead users about APISIX’s architecture. This PR corrects the terminology to ensure clarity and technical accuracy.

Which issue(s) this PR fixes:
Fixes #

Checklist

[x] I have explained the need for this PR and the problem it solves
[x] I have explained the changes or the new features added to this PR
[ ] I have added tests corresponding to this change

Not applicable: documentation-only change
[x] I have updated the documentation to reflect this change
[x] I have verified that this change is backward compatible

✅ Note: Since this is a documentation typo fix with no behavioral impact, no tests are required. The change improves clarity without altering functionality.

shreemaan-abhishek and others added 2 commits February 2, 2026 15:03
Signed-off-by: Abhishek Choudhary <shreemaan.abhishek@gmail.com>
This PR fixes a minor but potentially confusing typo in docs/en/latest/script.md (and its Chinese counterpart if applicable), where the terms "Script" and "Plugin" were incorrectly used interchangeably or mislabeled in a sentence describing APISIX's extension mechanisms.

In Apache APISIX, Scripts and Plugins are distinct concepts:
Plugins are reusable, configurable modules that hook into the request lifecycle (e.g., key-auth, limit-req).
Scripts refer to inline Lua logic attached directly to a Route (or Service) for custom, route-specific behavior.

The original wording blurred this distinction, which could mislead users about APISIX’s architecture. This PR corrects the terminology to ensure clarity and technical accuracy.

Which issue(s) this PR fixes:
Fixes #

Checklist

[x] I have explained the need for this PR and the problem it solves  
[x] I have explained the changes or the new features added to this PR  
[ ] I have added tests corresponding to this change  
  >Not applicable: documentation-only change  
[x] I have updated the documentation to reflect this change  
[x] I have verified that this change is backward compatible  

✅ Note: Since this is a documentation typo fix with no behavioral impact, no tests are required. The change improves clarity without altering functionality.
@dosubot dosubot bot added size:XS This PR changes 0-9 lines, ignoring generated files. doc Documentation things labels Feb 13, 2026
@Baoyuantop Baoyuantop changed the base branch from release/3.15 to master February 14, 2026 06:34
@dosubot dosubot bot added size:M This PR changes 30-99 lines, ignoring generated files. and removed size:XS This PR changes 0-9 lines, ignoring generated files. labels Feb 14, 2026
@Baoyuantop Baoyuantop changed the title Fix wording for Script and Plugin compatibility docs: fix wording for Script and Plugin compatibility Feb 14, 2026
@Baoyuantop
Copy link
Contributor

Hi @andrewbytecoder, I've modified the upstream branch; please merge it into the main branch to reduce the differences.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Documentation things size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants