Dashboard, Asset, Device docs. Updated#544
Merged
ashvayka merged 3 commits intoJul 14, 2026
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refreshes multiple ThingsBoard user-guide documentation pages (Devices, Dashboards, Assets, Profiles, Provisioning, AI Assistant, etc.) to reflect newer workflows—especially “connectivity check” guidance, expanded troubleshooting, and new AI-assisted configuration sections—while also updating related cross-links and an asset hierarchy diagram.
Changes:
- Expands core user-guide include docs for Devices/Dashboards/Assets/Profiles with updated workflows, troubleshooting tables, and clearer cross-linking.
- Adds new “Configure with AI” / “Generate dashboard with AI” documentation sections and availability banners across several guides.
- Updates supporting references (gateway API overview, troubleshooting doc links) and replaces the asset hierarchy SVG with a new layout.
Reviewed changes
Copilot reviewed 17 out of 18 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| src/content/docs/docs/user-guide/devices.mdx | Updates page metadata description for Devices (CE docs wrapper). |
| src/content/docs/docs/pe/user-guide/devices.mdx | Updates page metadata description for Devices (PE docs wrapper). |
| src/content/docs/docs/paas/user-guide/devices.mdx | Updates page metadata description for Devices (Cloud docs wrapper). |
| src/content/docs/docs/paas/eu/user-guide/devices.mdx | Updates page metadata description for Devices (Cloud EU docs wrapper). |
| src/content/docs/docs/paas/user-guide/dashboards.mdx | Updates page metadata description for Dashboards (Cloud docs wrapper). |
| src/content/_includes/docs/user-guide/provisioning.mdx | Adds X.509 Certificate Chain provisioning strategy details and related configuration fields. |
| src/content/_includes/docs/user-guide/notifications.mdx | Adds “Configure Notifications with AI” section and feature availability banner. |
| src/content/_includes/docs/user-guide/devices.mdx | Expands device workflow docs (connectivity check, AI dashboard generation, troubleshooting, related links). |
| src/content/_includes/docs/user-guide/device-profiles.mdx | Expands device profile documentation (key settings, troubleshooting, clearer tab descriptions). |
| src/content/_includes/docs/user-guide/dashboards.mdx | Adds “Configure Dashboard with AI”, reorganizes dashboard concepts, and expands sharing/public access guidance. |
| src/content/_includes/docs/user-guide/calculated-fields.mdx | Adds “Configure Calculated Fields with AI” section and availability banner. |
| src/content/_includes/docs/user-guide/assets.mdx | Clarifies assets vs devices, updates actions/tabs descriptions, simplifies group docs, adds troubleshooting. |
| src/content/_includes/docs/user-guide/asset-profiles.mdx | Expands asset profile docs (alarm rules, calculated fields, troubleshooting, usage notes). |
| src/content/_includes/docs/user-guide/alarm-rules.mdx | Adds “Configure Alarm Rules with AI” section and availability banner. |
| src/content/_includes/docs/user-guide/ai-assistant.mdx | Updates AI Assistant scope to include dashboards/notifications and fixes availability banner link target. |
| src/content/_includes/docs/troubleshooting.mdx | Updates device-profile anchor links (but introduces a duplicate heading that should be fixed). |
| src/content/_includes/docs/reference/gateway-api/overview.mdx | Updates gateway mode doc link to target the specific “Gateway Devices” section. |
| src/assets/schemas/asset-hierarchy.svg | Replaces asset hierarchy diagram with a new SVG layout and styling. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| {props.product !== Products.CE && <><li>If needed: In <strong>Owner and groups</strong>, change the dashboard owner or add it to a group.</li></>} | ||
| <li>Click <strong>Add</strong> — the dashboard opens automatically.</li> | ||
| <li>Click <strong>Save</strong> in the upper-right corner to store it.</li> | ||
| <li>Click <strong>Add</strong>. A new dashboard opens in <strong>edit mode</strong>, where you can add widgets, configure settings, and modify the layout — click <strong>Save</strong> in the upper-right corner to store it</li> |
| <Banner variant="peFeature" product={props.product}>AI Assistant is available in <DocLink product={Products.PE} path="installation/" target="_blank">ThingsBoard Professional</DocLink> and <a href="/installations/?product=thingsboard-cloud" target="_blank" rel="noopener noreferrer" class="tb-banner-ext"><b>ThingsBoard Cloud</b></a> only.</Banner> | ||
|
|
||
| To switch to dashboard edit mode, click the **Edit mode** button in the top-right corner. | ||
| **Configure with AI** lets you set up or modify a dashboard by describing what you want in plain language, instead of manually configuring aliases, time window, states, and widgets one by one. |
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.
Description
Type of change
src/content/docs/**)src/content/_includes/**)src/components/**,src/styles/**)src/pages/**,src/data/**)src/data/redirects.ts)releaseskill)Affected products
Related issues
Checklist
pnpm checkpasses (Astro / TypeScript)pnpm lint:eslintpassespnpm lint:slugcheckpasses (required if pages were added/renamed/moved across languages)pnpm lint:linkcheckpasses locally — required to merge; run it before requesting review (usepnpm lint:linkcheck:nobuildif you already ran a build)src/data/redirects.ts, andpnpm generate:redirectswas runsrc/data/versions.ts