chore(jq): refer to 1.8 docs + add incompatibilities#3339
Open
keynslug wants to merge 3 commits intorelease-6.2from
Open
chore(jq): refer to 1.8 docs + add incompatibilities#3339keynslug wants to merge 3 commits intorelease-6.2from
keynslug wants to merge 3 commits intorelease-6.2from
Conversation
Also refine wording a bit to sound naturally.
🔗 Link Check ResultsSummary
Errors per inputErrors in en_US/emqx-ai/rtc-services/volcengine-rtc/quick-start.md
Errors in en_US/getting-started/feature-comparison.md
Errors in ja_JP/emqx-ai/rtc-services/volcengine-rtc/quick-start.md
Errors in ja_JP/performance/benchmark-emqtt-bench.md
Errors in zh_CN/emqx-ai/rtc-services/volcengine-rtc/quick-start.md
Errors in zh_CN/faq/concept.md
Errors in zh_CN/getting-started/feature-comparison.md
Errors in zh_CN/index.md
Errors in zh_CN/support/technical-support.md
|
zmstone
previously approved these changes
Jan 19, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Updates jq-related documentation to point to the current jq site/manual (v1.8) and documents jq 1.6.1 → 1.8.1 incompatibilities in the EMQX 6.0 breaking-changes notes.
Changes:
- Update jq homepage/manual links to
jqlang.organd the v1.8 manual in both zh_CN and en_US docs. - Add a new “6.2.0” section describing jq 1.8.1 incompatibilities in both zh_CN and en_US breaking-changes pages.
- Minor English wording/formatting refinements in the jq rule SQL doc.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| zh_CN/data-integration/rule-sql-jq.md | Updates jq homepage/manual links to the jqlang v1.8 manual. |
| en_US/data-integration/rule-sql-jq.md | Updates jq homepage/manual link and refines intro wording/formatting. |
| zh_CN/changes/breaking-changes-6.0.md | Adds a 6.2.0 entry documenting jq 1.8.1 incompatibilities. |
| en_US/changes/breaking-changes-6.0.md | Adds a 6.2.0 entry documenting jq 1.8.1 incompatibilities (English). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| - [#16589](https://github.com/emqx/emqx/pull/16589) The jq language in the Rule Engine runtime has been upgraded from version 1.6.1 to 1.8.1, introducing several subtle incompatibilities. These are unlikely to affect your deployment but are documented here for completeness. | ||
|
|
||
| - **Providing empty string as jq program is now considered an error**: use `"."` instead. ([jq#2790](https://github.com/jqlang/jq/pull/2790)) |
|
|
||
| - **Providing empty string as jq program is now considered an error**: use `"."` instead. ([jq#2790](https://github.com/jqlang/jq/pull/2790)) | ||
|
|
||
| - **String functions now use code point indices** : `indices/1`, `index/1`, and `rindex/1` functions now use code point indices instead of byte indices; use `utf8bytelength/0` to get byte index if needed. ([jq#3065](https://github.com/jqlang/jq/pull/3065)) |
| EMQX rules allow users to define SQL-like rules to process and route messages. These rules can include jq functions to perform complex transformations on JSON payloads as they pass through the broker. | ||
|
|
||
| If you are new to jq function, you can refer to the [Reference](#references) section to speedily get started. | ||
| If you are new to jq language, you can refer to the [Reference](#references) section to get started quickly. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Also refine wording a bit to sound naturally.