From 9a45dc657c54e097c519f94f1e9b929275d43cb6 Mon Sep 17 00:00:00 2001 From: Frederico Minuzzi Date: Fri, 29 May 2026 14:29:37 -0300 Subject: [PATCH 1/3] docs(tagotip): add tutorial video links to introduction and transport pages Closes #78 --- docs/tagotip/introduction.md | 11 +++++++++++ docs/tagotip/transports/http.md | 4 ++++ docs/tagotip/transports/mqtt.md | 4 ++++ docs/tagotip/transports/tcp.md | 4 ++++ docs/tagotip/transports/udp.md | 4 ++++ 5 files changed, 27 insertions(+) diff --git a/docs/tagotip/introduction.md b/docs/tagotip/introduction.md index 7a1e5a54..83fad81f 100644 --- a/docs/tagotip/introduction.md +++ b/docs/tagotip/introduction.md @@ -15,6 +15,17 @@ Send IoT data to TagoIO in **130 bytes** instead of 487. No JSON, no HTTP header PUSH|4deedd7bab8817ec|sensor-01|[temperature:=32.5#C;humidity:=65#%] ``` +## Tutorials + +Follow our tutorials to start building your IoT project using UDP, TCP, HTTP, or MQTT: + +:::tip Get started with TagoTiP +- [TagoTiP UDP — Quick Start](https://community.tago.io/t/tagotip-udp-tutorial) +- [TagoTiP TCP — Quick Start](https://community.tago.io/t/tagotip-tcp-tutorial) +- [TagoTiP HTTP — Quick Start](https://community.tago.io/t/tagotip-http-tutorial) +- [TagoTiP MQTT — Quick Start](https://community.tago.io/t/tagotip-mqtt-tutorial) +::: + ## Why TagoTiP? | | HTTP/JSON | TagoTiP | TagoTiP(s) (encrypted) | diff --git a/docs/tagotip/transports/http.md b/docs/tagotip/transports/http.md index ecfef501..46e5bf4b 100644 --- a/docs/tagotip/transports/http.md +++ b/docs/tagotip/transports/http.md @@ -8,6 +8,10 @@ keywords: [tagotip, iot, http, rest, api] # TagoTiP over HTTP +:::tip Tutorial +Follow our step-by-step tutorial to connect your first device over HTTP: [TagoTiP HTTP — Quick Start](https://community.tago.io/t/tagotip-http-tutorial) +::: + Standard HTTP you already know - `POST` to send, `GET` to retrieve, `HEAD` to ping. A single `Authorization` header and a clean REST-style API. Works through every firewall and proxy. ## Endpoint diff --git a/docs/tagotip/transports/mqtt.md b/docs/tagotip/transports/mqtt.md index fb08bf2f..b0e6f30e 100644 --- a/docs/tagotip/transports/mqtt.md +++ b/docs/tagotip/transports/mqtt.md @@ -8,6 +8,10 @@ keywords: [tagotip, iot, mqtt, pub/sub, qos] # TagoTiP over MQTT +:::tip Tutorial +Follow our step-by-step tutorial to connect your first device over MQTT: [TagoTiP MQTT — Quick Start](https://community.tago.io/t/tagotip-mqtt-tutorial) +::: + **Publish/subscribe messaging** with QoS delivery guarantees. TagoTiP over MQTT maps the protocol to standard MQTT topics - the server pushes commands to your device in real time, and QoS levels handle delivery reliability at the transport layer. ## Endpoint diff --git a/docs/tagotip/transports/tcp.md b/docs/tagotip/transports/tcp.md index 81fda92a..ea2362f8 100644 --- a/docs/tagotip/transports/tcp.md +++ b/docs/tagotip/transports/tcp.md @@ -8,6 +8,10 @@ keywords: [tagotip, iot, tcp, persistent connection, tls] # TagoTiP over TCP +:::tip Tutorial +Follow our step-by-step tutorial to connect your first device over TCP: [TagoTiP TCP — Quick Start](https://community.tago.io/t/tagotip-tcp-tutorial) +::: + **Guaranteed delivery** and **real-time commands**. TagoTiP over TCP ensures every data point arrives in order - and the server can push commands to your device the moment they are ready. ## Endpoint diff --git a/docs/tagotip/transports/udp.md b/docs/tagotip/transports/udp.md index 733de7db..2214c5c2 100644 --- a/docs/tagotip/transports/udp.md +++ b/docs/tagotip/transports/udp.md @@ -8,6 +8,10 @@ keywords: [tagotip, iot, udp, datagram, low power] # TagoTiP over UDP +:::tip Tutorial +Follow our step-by-step tutorial to connect your first device over UDP: [TagoTiP UDP — Quick Start](https://community.tago.io/t/tagotip-udp-tutorial) +::: + The **fastest path** from sensor to cloud. No connection setup, no handshake - a single datagram carries your data to TagoIO in as few as 60 bytes. ## Endpoint From 09b3bda72e11a785794d73639f5422233cc612c1 Mon Sep 17 00:00:00 2001 From: Frederico Minuzzi Date: Fri, 29 May 2026 14:40:19 -0300 Subject: [PATCH 2/3] docs(tagotip): update tutorial links to YouTube videos --- docs/tagotip/introduction.md | 22 +++++++++++----------- docs/tagotip/transports/http.md | 2 +- docs/tagotip/transports/mqtt.md | 2 +- docs/tagotip/transports/tcp.md | 2 +- docs/tagotip/transports/udp.md | 2 +- 5 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/tagotip/introduction.md b/docs/tagotip/introduction.md index 83fad81f..051eb977 100644 --- a/docs/tagotip/introduction.md +++ b/docs/tagotip/introduction.md @@ -15,17 +15,6 @@ Send IoT data to TagoIO in **130 bytes** instead of 487. No JSON, no HTTP header PUSH|4deedd7bab8817ec|sensor-01|[temperature:=32.5#C;humidity:=65#%] ``` -## Tutorials - -Follow our tutorials to start building your IoT project using UDP, TCP, HTTP, or MQTT: - -:::tip Get started with TagoTiP -- [TagoTiP UDP — Quick Start](https://community.tago.io/t/tagotip-udp-tutorial) -- [TagoTiP TCP — Quick Start](https://community.tago.io/t/tagotip-tcp-tutorial) -- [TagoTiP HTTP — Quick Start](https://community.tago.io/t/tagotip-http-tutorial) -- [TagoTiP MQTT — Quick Start](https://community.tago.io/t/tagotip-mqtt-tutorial) -::: - ## Why TagoTiP? | | HTTP/JSON | TagoTiP | TagoTiP(s) (encrypted) | @@ -98,6 +87,17 @@ PULL|4deedd7bab8817ec|sensor-01|[temperature] <- ACK|OK|[temperature:=32.5#C@1694567890000] ``` +## Tutorials + +Follow our tutorials to start building your IoT project using UDP, TCP, HTTP, or MQTT: + +:::tip Get started with TagoTiP +- [TagoTiP UDP — Quick Start](https://youtu.be/YhhHuCH7UZo) +- [TagoTiP TCP — Quick Start](https://youtu.be/cSMbQkPyrZo) +- [TagoTiP HTTP — Quick Start](https://youtu.be/oZfrq5xFS5k) +- [TagoTiP MQTT — Quick Start](https://youtu.be/EHnG_P28MPE) +::: + ## SDKs All language SDKs share a single Rust core (`tagotip-codec`, `no_std`), so parsing and frame building behave identically everywhere. diff --git a/docs/tagotip/transports/http.md b/docs/tagotip/transports/http.md index 46e5bf4b..4fb1570d 100644 --- a/docs/tagotip/transports/http.md +++ b/docs/tagotip/transports/http.md @@ -9,7 +9,7 @@ keywords: [tagotip, iot, http, rest, api] # TagoTiP over HTTP :::tip Tutorial -Follow our step-by-step tutorial to connect your first device over HTTP: [TagoTiP HTTP — Quick Start](https://community.tago.io/t/tagotip-http-tutorial) +Follow our step-by-step tutorial to connect your first device over HTTP: [TagoTiP HTTP — Quick Start](https://youtu.be/oZfrq5xFS5k) ::: Standard HTTP you already know - `POST` to send, `GET` to retrieve, `HEAD` to ping. A single `Authorization` header and a clean REST-style API. Works through every firewall and proxy. diff --git a/docs/tagotip/transports/mqtt.md b/docs/tagotip/transports/mqtt.md index b0e6f30e..107465f7 100644 --- a/docs/tagotip/transports/mqtt.md +++ b/docs/tagotip/transports/mqtt.md @@ -9,7 +9,7 @@ keywords: [tagotip, iot, mqtt, pub/sub, qos] # TagoTiP over MQTT :::tip Tutorial -Follow our step-by-step tutorial to connect your first device over MQTT: [TagoTiP MQTT — Quick Start](https://community.tago.io/t/tagotip-mqtt-tutorial) +Follow our step-by-step tutorial to connect your first device over MQTT: [TagoTiP MQTT — Quick Start](https://youtu.be/EHnG_P28MPE) ::: **Publish/subscribe messaging** with QoS delivery guarantees. TagoTiP over MQTT maps the protocol to standard MQTT topics - the server pushes commands to your device in real time, and QoS levels handle delivery reliability at the transport layer. diff --git a/docs/tagotip/transports/tcp.md b/docs/tagotip/transports/tcp.md index ea2362f8..d2c951c9 100644 --- a/docs/tagotip/transports/tcp.md +++ b/docs/tagotip/transports/tcp.md @@ -9,7 +9,7 @@ keywords: [tagotip, iot, tcp, persistent connection, tls] # TagoTiP over TCP :::tip Tutorial -Follow our step-by-step tutorial to connect your first device over TCP: [TagoTiP TCP — Quick Start](https://community.tago.io/t/tagotip-tcp-tutorial) +Follow our step-by-step tutorial to connect your first device over TCP: [TagoTiP TCP — Quick Start](https://youtu.be/cSMbQkPyrZo) ::: **Guaranteed delivery** and **real-time commands**. TagoTiP over TCP ensures every data point arrives in order - and the server can push commands to your device the moment they are ready. diff --git a/docs/tagotip/transports/udp.md b/docs/tagotip/transports/udp.md index 2214c5c2..8aad21d7 100644 --- a/docs/tagotip/transports/udp.md +++ b/docs/tagotip/transports/udp.md @@ -9,7 +9,7 @@ keywords: [tagotip, iot, udp, datagram, low power] # TagoTiP over UDP :::tip Tutorial -Follow our step-by-step tutorial to connect your first device over UDP: [TagoTiP UDP — Quick Start](https://community.tago.io/t/tagotip-udp-tutorial) +Follow our step-by-step tutorial to connect your first device over UDP: [TagoTiP UDP — Quick Start](https://youtu.be/YhhHuCH7UZo) ::: The **fastest path** from sensor to cloud. No connection setup, no handshake - a single datagram carries your data to TagoIO in as few as 60 bytes. From 107ad0ef038ed39d876bb406ffc889eec1a98237 Mon Sep 17 00:00:00 2001 From: Frederico Minuzzi Date: Fri, 29 May 2026 14:44:16 -0300 Subject: [PATCH 3/3] docs(tagotip): add quick-start tutorial links to introduction and transport pages --- docs/tagotip/introduction.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/tagotip/introduction.md b/docs/tagotip/introduction.md index 051eb977..1728e6d9 100644 --- a/docs/tagotip/introduction.md +++ b/docs/tagotip/introduction.md @@ -92,11 +92,12 @@ PULL|4deedd7bab8817ec|sensor-01|[temperature] Follow our tutorials to start building your IoT project using UDP, TCP, HTTP, or MQTT: :::tip Get started with TagoTiP + - [TagoTiP UDP — Quick Start](https://youtu.be/YhhHuCH7UZo) - [TagoTiP TCP — Quick Start](https://youtu.be/cSMbQkPyrZo) - [TagoTiP HTTP — Quick Start](https://youtu.be/oZfrq5xFS5k) - [TagoTiP MQTT — Quick Start](https://youtu.be/EHnG_P28MPE) -::: + ::: ## SDKs