From 2a487e67083ae7a728874f5559584b9ef22dd6f8 Mon Sep 17 00:00:00 2001 From: AnnsAnn Date: Tue, 1 Jul 2025 16:43:08 +0200 Subject: [PATCH] doc: move vision to starlight, deprecate vision in doxygen --- doc/doxygen/src/vision.md | 54 +---------------- .../src => guides/general/img}/vision.svg | 0 doc/guides/general/vision.md | 60 +++++++++++++++++++ doc/starlight/astro.config.mjs | 1 + 4 files changed, 62 insertions(+), 53 deletions(-) rename doc/{doxygen/src => guides/general/img}/vision.svg (100%) create mode 100644 doc/guides/general/vision.md diff --git a/doc/doxygen/src/vision.md b/doc/doxygen/src/vision.md index 1c888fb748..8872bf5e3b 100644 --- a/doc/doxygen/src/vision.md +++ b/doc/doxygen/src/vision.md @@ -1,55 +1,3 @@ # RIOT Vision {#vision} -![RIOT Vision: From proprietary manufacturer silos to a truly open cyber-physical system](vision.svg) - -We expect an evolution in the software platforms powering Internet of Things -devices that can be compared, to some extent, to the recent evolution of -software platforms powering smartphones. - -In a few years time, software platforms powering smart handheld devices has -speed-evolved from a state where dozens of closed-source, slow progress, -proprietary solutions where used, to a state where a couple of major players -have imposed new de facto standards in terms of software platform openness, -interoperability, and automatic updating. On the bright side, this has led to -much quicker paced progress, and to the development of billions of new -applications built on top of these platforms, which interact in innovative ways -with one another and with the cloud. At this point, let's make two remarks about -the dark side of this evolution. First, while companies pushing iOS and Android -use such software platforms as more tools to achieve profit-oriented goals -(e.g., accumulating and monetizing personalized information), RIOT is developed -and maintained by a non-profit, open source community of developers organized -around principles that are mainly inspired by the Linux community or the IETF -community. Second, while the true level of openness of iOS or Android is debatable, -RIOT aims instead at a Linux-like openness. - -That said, we expect a revolution in the software platforms powering Internet of -Things (IoT) devices, and we expect this revolution to be as game-changing as -the aforementioned evolution of the software platforms powering smart handheld -devices (retaining only its bright side, hopefully). It is yet unclear which IoT -software platforms will emerge as dominant -- RIOT is a contender. It is however -quite likely that new standards will be set in the near future, in terms of IoT -software platform openness, API, automated software updates and other -characteristics that are necessary to enable a modern, large scale, secure ecosystem. -Such an IoT software evolution will quite likely fuel a new world of distributed -applications developed by a large variety of actors, on top of the dominant open -software platform(s). These applications will leverage both spontaneous wireless -networks, the cloud and the denser, interconnected environment of heterogeneous -devices that we will find ourselves in. - -Our vision is the emergence of an entirely new reality in which our interface to -the Internet will no longer be predominantly a screen, but rather the objects of -the cyber-physical system embodied by the Internet of Things itself. RIOT is an -open source operating system that aims to power IoT devices in this new reality. -RIOT aims to provide a powerful, but very low memory footprint software platform, -that enables any programmer to develop applications on typical IoT devices with -zero learning curve (assuming prior experience with POSIX and Linux for instance). -RIOT aims for shortened development life-cycles, using standard languages, and -well-known debugging tools. RIOT implements a micro-kernel architecture that provides -built-in robustness, real-time capabilities and energy efficiency -- future-proof -properties, required by many IoT applications to come. - -In this context RIOT aims to power a modern, large scale, evolutive, and secure -cyber-physical ecosystem, comprising of heterogeneous IoT devices, distributed -processes and applications, that can seamlessly interconnect with one another -and with the cloud, leveraging standard network stacks (including IPv6 -interoperability) available in RIOT. +@deprecated See [Vision](https://guide.riot-os.org/general/vision/) on the RIOT Guide Site for the latest information. This page will be removed after release 2025.11. diff --git a/doc/doxygen/src/vision.svg b/doc/guides/general/img/vision.svg similarity index 100% rename from doc/doxygen/src/vision.svg rename to doc/guides/general/img/vision.svg diff --git a/doc/guides/general/vision.md b/doc/guides/general/vision.md new file mode 100644 index 0000000000..3b391c7e13 --- /dev/null +++ b/doc/guides/general/vision.md @@ -0,0 +1,60 @@ +--- +title: Vision +description: From proprietary manufacturer silos to a truly open cyber-physical system +--- + +:::tip[RIOT Vision] +![RIOT Vision: From proprietary manufacturer silos to a truly open cyber-physical system](img/vision.svg) +::: + +We expect an evolution in the software platforms powering Internet of Things +devices that can be compared, to some extent, to the recent evolution of +software platforms powering smartphones. + +In a few years time, software platforms powering smart handheld devices has +speed-evolved from a state where dozens of closed-source, slow progress, +proprietary solutions where used, to a state where a couple of major players +have imposed new de facto standards in terms of software platform openness, +interoperability, and automatic updating. On the bright side, this has led to +much quicker paced progress, and to the development of billions of new +applications built on top of these platforms, which interact in innovative ways +with one another and with the cloud. At this point, let's make two remarks about +the dark side of this evolution. First, while companies pushing iOS and Android +use such software platforms as more tools to achieve profit-oriented goals +(e.g., accumulating and monetizing personalized information), RIOT is developed +and maintained by a non-profit, open source community of developers organized +around principles that are mainly inspired by the Linux community or the IETF +community. Second, while the true level of openness of iOS or Android is debatable, +RIOT aims instead at a Linux-like openness. + +That said, we expect a revolution in the software platforms powering Internet of +Things (IoT) devices, and we expect this revolution to be as game-changing as +the aforementioned evolution of the software platforms powering smart handheld +devices (retaining only its bright side, hopefully). It is yet unclear which IoT +software platforms will emerge as dominant -- RIOT is a contender. It is however +quite likely that new standards will be set in the near future, in terms of IoT +software platform openness, API, automated software updates and other +characteristics that are necessary to enable a modern, large scale, secure ecosystem. +Such an IoT software evolution will quite likely fuel a new world of distributed +applications developed by a large variety of actors, on top of the dominant open +software platform(s). These applications will leverage both spontaneous wireless +networks, the cloud and the denser, interconnected environment of heterogeneous +devices that we will find ourselves in. + +Our vision is the emergence of an entirely new reality in which our interface to +the Internet will no longer be predominantly a screen, but rather the objects of +the cyber-physical system embodied by the Internet of Things itself. RIOT is an +open source operating system that aims to power IoT devices in this new reality. +RIOT aims to provide a powerful, but very low memory footprint software platform, +that enables any programmer to develop applications on typical IoT devices with +zero learning curve (assuming prior experience with POSIX and Linux for instance). +RIOT aims for shortened development life-cycles, using standard languages, and +well-known debugging tools. RIOT implements a micro-kernel architecture that provides +built-in robustness, real-time capabilities and energy efficiency -- future-proof +properties, required by many IoT applications to come. + +In this context RIOT aims to power a modern, large scale, evolutive, and secure +cyber-physical ecosystem, comprising of heterogeneous IoT devices, distributed +processes and applications, that can seamlessly interconnect with one another +and with the cloud, leveraging standard network stacks (including IPv6 +interoperability) available in RIOT. diff --git a/doc/starlight/astro.config.mjs b/doc/starlight/astro.config.mjs index 4d141e673c..6d6715df6e 100644 --- a/doc/starlight/astro.config.mjs +++ b/doc/starlight/astro.config.mjs @@ -46,6 +46,7 @@ export default defineConfig({ items: [ { label: "Introduction", slug: "index" }, "general/structure", + "general/vision", ], }, {