Skip to content

chore(jq): refer to 1.8 docs + add incompatibilities#3339

Open
keynslug wants to merge 3 commits intorelease-6.2from
chore/jq/urls
Open

chore(jq): refer to 1.8 docs + add incompatibilities#3339
keynslug wants to merge 3 commits intorelease-6.2from
chore/jq/urls

Conversation

@keynslug
Copy link
Contributor

Also refine wording a bit to sound naturally.

Also refine wording a bit to sound naturally.
@github-actions
Copy link

github-actions bot commented Jan 19, 2026

🔗 Link Check Results

Summary

Status Count
🔍 Total 8569
✅ Successful 8165
⏳ Timeouts 1
🔀 Redirected 175
👻 Excluded 216
❓ Unknown 0
🚫 Errors 10
⛔ Unsupported 2

Errors per input

Errors 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

Full Github Actions output

@keynslug keynslug changed the title chore(jq): use up-to-date URLs chore(jq): refer to 1.8 docs + add incompatibilities Jan 19, 2026
zmstone
zmstone previously approved these changes Jan 19, 2026
@zmstone zmstone modified the milestones: 6.2, 6.2.0 Jan 19, 2026
@keynslug keynslug marked this pull request as ready for review January 21, 2026 12:52
@Meggielqk Meggielqk changed the base branch from release-6.1 to release-6.2 January 22, 2026 01:24
@Meggielqk Meggielqk dismissed zmstone’s stale review January 22, 2026 01:24

The base branch was changed.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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.org and 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.
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.

4 participants