[Updating Documentation] New TagoIO Admin Interface #25
Open
Freddyminu wants to merge 21 commits into
Open
Conversation
Freddyminu
changed the title
Freddyminu
force-pushed
the
feat/nextAdminDocUpdates
branch
from
b570b11 to
d278695
Compare
Replace and clean up image assets across the documentation. Add CSS and MDX component support for rounded borders on images and a GIF wrapper that clips and styles animated content consistently.
Rewrite and expand instructions for actions, analysis, dashboards, devices, widgets, getting-started, and tutorials. Updates include new screenshots, clearer step-by-step guidance, and restructured content for better readability.
Apply grammar corrections, fix typos, standardize 'Tago' to 'TagoIO' where appropriate, and make minor wording improvements across 170+ documentation pages.
Freddyminu
force-pushed
the
feat/nextAdminDocUpdates
branch
from
f8623eb to
a43a65f
Compare
Introduces a dedicated Tago AI section covering the assistant overview, chat interface and modes (Read/Write/Full), and bring-your-own AI provider configuration. Adds TagoAI requests to the Services table with per-plan monthly limits, and cross-links the Analysis script editor and debug console to the new pages.
- Corrected the title of the Tago AI Service for consistency. - Replaced images with updated versions with grey borders.
docs: add Tago AI documentation section
Moved MCP to AI category
…ance for map widget - Add GeoJSON (Point) as recommended location format with coordinate order caution - Keep legacy lat/lng format as still supported - Fix "series" → "groups" terminology for grouping feature - Add section on managing multiple stationary devices via accumulator device pattern
Freddyminu
force-pushed
the
feat/nextAdminDocUpdates
branch
from
902ba9e to
63afca8
Compare
Freddyminu
requested review from
felipefdl
and removed request for
PhilGutierre
# Conflicts: # docs/tagoio/actions/trigger-by-mqtt-topic.md
docs: document GeoJSON location format and stationary device guidance for map widget
- Renamed all rounded-image-* PNGs to descriptive kebab-case names based on doc context and visual content - Renamed peek_* and other opaque GIF names to descriptive names - Deleted ~170 orphaned images and GIFs not referenced by any doc - Updated all image references across docs to match new filenames
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
3 participants
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.
Summary
Refreshes documentation across the TagoIO docs site: replaces outdated admin UI screenshots with current-interface images, adds a new Tago AI section, adds TDeploy API reference pages, reorganizes getting-started content into topic sections, and removes deprecated content. 991 files changed.
What changed
Tago AI docs (new section)
tagoio/tago-ai/covering AI provider configuration, Tago AI usage, and MCP-powered IoT data integrationprofiles/services/tago-ai-service.mddocumenting the service in profile settingsTDeploy API reference
docs/api-tdeploy/pages: create/delete/list/update MQTT clients, list project services, sidebar, and info pagenpm run fmtSection reorganization
Moved standalone pages out of Getting Started into the sections they belong to (git tracks these as renames, so history is preserved):
getting-started/restful-api.mdtoapi/restful-api.mdgetting-started/tags-system.mdtodevices/tags-system.mdgetting-started/entities.mdtoentities/managing-entities.md, plus a newentities/section with an overview pagegetting-started/secrets.mdtosecurity/secrets.mdgetting-started/notification.mdtotagorun/notification.md_category_.json) to match the new layoutImage overhaul
rounded-image-*.png) across all new screenshotspeek_*.gif) added for key UI workflowsstatic/img/andstatic/docs_imagem/Styling and components
src/css/custom.css: added.rounded-image,.gif-wrapper, and.gif-imageclassessrc/theme/MDXComponents.tsx: custom<img>component that auto-wraps.giffiles in a styled containerContent updates (pages across the Widgets, TagoRUN, Devices, Integrations, Tutorials, My Account, Dashboards, Actions, Profiles, Analysis, and Getting Started sections)
Pages removed
using-the-device-emulator.md- content merged into device emulator docsbuilding-solutions.md,deploying-applications.md,how-it-works.md- consolidated intogetting-started.mdthinxtra-xkit-for-sigfox.md- deprecated tutorial removedticket-severity-options.md+support/_category_.json- support section removedInfrastructure
cdk/lambda/index.js: updated redirects for consolidated and removed pages.github/workflows/beta-deploy.yml: updated deploy trigger branchTest plan
npm install && npm run start/docs/tagoio/tago-ai//docs/api-tdeploy//api/restful-api,/devices/tags-system,/entities/managing-entities,/security/secrets,/tagorun/notification)/building-solutions,/deploying-applications,/how-it-works)Risk (CIA)
Likelihood: ⚪ None | Impact: ⚪ None | Exposure: ⚪ None
Documentation-only PR; no application behavior change. CDK redirect changes only affect removed doc paths.