From 667f57c96c8172f3d3bf9b3cc8cfe4b450a4ed32 Mon Sep 17 00:00:00 2001 From: Mike Szczys Date: Mon, 27 Nov 2023 14:46:50 -0600 Subject: [PATCH] landing-page: update summary and navigation * Tighten up summary to more closely reflect our current marketing. * Update navigation section to reflect relocated sections. Signed-off-by: Mike Szczys --- docs/landing_page.md | 41 ++++++++++++++++++++++++++++++----------- 1 file changed, 30 insertions(+), 11 deletions(-) diff --git a/docs/landing_page.md b/docs/landing_page.md index aa615f53..47a3fe37 100644 --- a/docs/landing_page.md +++ b/docs/landing_page.md @@ -9,13 +9,19 @@ hide_title: true --- -Golioth is an IoT platform that provides cloud services for embedded devices. Colloquially, we hope to solve the “impedance mismatch between hardware and cloud engineering teams" (a phrase we learned from an early user). Golioth is purpose-built for you and the hardware you develop. Enable everything that your devices need from the cloud, including device messaging, security, updates, analytics, and more. - -We chose the [the Zephyr Project™](https://www.zephyrproject.org), as the basis of our first embedded offering. Zephyr is an open-source, safe, secure, and flexible RTOS under the Linux Foundation. We offer the Golioth SDK--built on top of the Zephyr SDK--which you can use to quickly bootstrap an IoT application. +Golioth is an IoT platform that provides cloud services for embedded devices. We +think of our platform as a "universal connector". Golioth is purpose-built for +you and the hardware you develop. Golioth enables everything that your devices +need from the cloud, from establishing secure connections and providing +over-the-air updates, to managing data to/from your fleet and connecting that to +any cloud service you may need. ## Get started today -To get started, check out the [Quickstart Guide](/getting-started/). That will get you set up with a Golioth account and help you to provision your first devices. Then you can choose which platform to try out using our [supported hardware](/firmware/hardware). +Our [Quickstart Guide](/getting-started/) gets you set up with a Golioth account +and walks through how to provision your first devices. From there you can run a +pre-compiled binary, or build your own samples from our device SDKs. Either way, +you will have an IoT test fleet connected and sending data to the cloud today. ## Using Golioth with your IoT Hardware @@ -52,10 +58,23 @@ us](mailto:hello@golioth.io). ## Navigation -There are 5 major sections on the Golioth Docs page: - -- [Getting Started](/getting-started) - Start here! If you are confused at all, please [join our Discord](https://golioth.io/discord) or [let us know directly](mailto:devrel@golioth.io) -- [Hardware](/firmware/hardware) - This section details which device platforms are explicitly supported and how you can get started with them quickly. There is also a catalog of all hardware that works with Golioth and whether or not it has been verified by the Golioth team, the community, the Zephyr community, etc. -- [Firmware](/firmware) - This is the "device side" features of our offerings, including device Software Development Kets (SDKs). This section shows how to run the sample firmware that connects to the offerings in the Services section. -- [Cloud](/device-management) - This is the "server side" features of our offerings. Your embedded hardware will communicate with Golioth Services to push and pull information to the broader internet. This section details how to control and interact with each service, and also test the service without any hardware involved. This section also details how to interact with that data via webapps, mobile apps, and from anywhere else on the web. Make calls to the Golioth web API and display your users' data! -- [Reference](/reference) - All generated API documentation lives here, including for the web side API and the Zephyr API +- [Getting Started](/getting-started) - Start here! If you get stuck, please + post your questions on [the Golioth Forum](https://forum.golioth.io/) or [let + us know directly](mailto:devrel@golioth.io). +- [Firmware](/firmware) - These are the "device side" features of our offerings, + including device Software Development Kits (SDKs). This section shows how to + set up a build environment, run sample firmware, and use Golioth services on + your microcontroller-based IoT fleet. +- [Device Management](/device-management) - These are "server side" features of + the Golioth platform that deal with controlling your devices in the filed. + Here you will find details about rolling out over-the-air (OTA) firmware + updates, accessing device logs, changing device settings for your fleet, and + issuing remote procedure calls (RPC). +- [Data Handling](/data-handling) - These are "server side" features of the + Golioth platform that deal with data moving to and from our IoT fleet. Here + you will find details about accessing stored data from your devices, and + options for routing that data to other platforms, whether that's your own + server, your database backend, or just about any other data service you can + imagine. +- [Reference](/reference) - All generated API documentation lives here, + including for the web side API and the Zephyr API