From f3f6a6a242e3f75613f7b0f4947721436cba7d44 Mon Sep 17 00:00:00 2001 From: Grzegorz Ferenc Date: Mon, 13 Jan 2025 16:42:14 +0100 Subject: [PATCH] doc: add-ons: add information about the index Added mentions of the nRF Connect SDK Add-ons page and the ncs-app-index repository to the pages Create an application and Integrations. Added a glossary entry. VSC-2765. Signed-off-by: Grzegorz Ferenc --- doc/nrf/app_dev/create_application.rst | 32 ++++++++++++++++++++++++++ doc/nrf/glossary.rst | 6 +++++ doc/nrf/integrations.rst | 4 ++++ 3 files changed, 42 insertions(+) diff --git a/doc/nrf/app_dev/create_application.rst b/doc/nrf/app_dev/create_application.rst index 6de4e24fb583..7979fa7da9ae 100644 --- a/doc/nrf/app_dev/create_application.rst +++ b/doc/nrf/app_dev/create_application.rst @@ -100,6 +100,7 @@ This application type is suitable for the following development cases: * You want to make changes to one or more of the repositories of the |NCS| when working on the application. * You want to develop a project that involves more than one board target, for example using a mesh networking protocol like :ref:`ug_matter` or :ref:`ug_bt_mesh`. * You want to run a big project that lets you develop most features without having to patch the |NCS| tree, for example with out-of-tree boards, drivers, SoCs, and so on. +* You want to use out-of-tree applications from the `nRF Connect SDK Add-ons`_ index. For more information about applications placed in workspace in the |NCS|, see the :ref:`workflow 4 on the development model page `. @@ -291,3 +292,34 @@ Use the following steps depending on the application type: This allows CMake to automatically load the boilerplate code required for building |NCS| applications. You can now start :ref:`configuring and building ` the application using the command line. + +.. _creating_add_on_index: + +Creating application from Add-On Index +====================================== + +You can create a :ref:`workspace application ` also by browsing and copying reference applications from the `nRF Connect SDK Add-on Index `_. +The index is a collection of publicly available |NCS| supplementary components that extend the SDK's functionality. +In addition to applications, it includes drivers, libraries, and protocol implementations. + +To create an application from the add-on index, complete the following steps: + +.. tabs:: + + .. tab:: nRF Connect for VS Code (recommended) + + The add-on applications can be created using the following steps in the |nRFVSC|: + + 1. In the :guilabel:`Welcome View`, click :guilabel:`Create a new application`. + #. Select :guilabel:`Browse nRF Connect SDK Add-on Index`. + #. Browse through the available add-ons and select one that matches your needs. + #. Follow the creation wizard to set up your workspace application. + + .. tab:: Command line + + When creating add-on applications from the command line, follow the instructions provided in the `nRF Connect SDK Add-ons`_ repository. + These instructions will guide you through the process of copying and configuring the add-on application in your workspace. + +The add-on will be copied to your workspace and automatically configured with a west workspace, allowing you to start development right away. + +For more information, including how to contribute your own add-on to the index, read the :file:`README.md` and :file:`CONTRIBUTING.md` files in the `ncs-app-index repository `_. diff --git a/doc/nrf/glossary.rst b/doc/nrf/glossary.rst index 7d14772eab77..367176362d0f 100644 --- a/doc/nrf/glossary.rst +++ b/doc/nrf/glossary.rst @@ -603,6 +603,12 @@ Glossary It includes a public REST API that can be used for building IoT solutions. See `nRF Cloud`_. + nRF Connect SDK Add-ons + An index of publicly available supplementary components that extend the |NCS|'s functionality. + The index can be accessed from the |nRFVSC|, and can also be browsed on `add-on webpage `_. + Add-ons in the index follow specific contribution guidelines and are maintained by their respective owners. + For more information, including how to contribute your own add-on to the index, read the :file:`README.md` and :file:`CONTRIBUTING.md` files in the `ncs-app-index repository `_. + nRF repository An |NCS| repository, hosted in the `nrfconnect GitHub organization`_, that does not have an externally maintained, open-source upstream. It is exclusive to Nordic development. diff --git a/doc/nrf/integrations.rst b/doc/nrf/integrations.rst index 30374245715c..45898ff4cff3 100644 --- a/doc/nrf/integrations.rst +++ b/doc/nrf/integrations.rst @@ -11,6 +11,10 @@ Integrations of the following third-party products are documented in their priva In the case of Find My, MFi licensees can get access to the repository by issuing a Nordic `DevZone`_ private ticket. +.. note:: + Some of these integrations are available through the `nRF Connect SDK Add-ons`_ page, which provides a curated collection of supplementary |NCS| components. + For more information, including how to contribute your own add-on to the index, read the :file:`README.md` and :file:`CONTRIBUTING.md` files in the `ncs-app-index repository `_. + The following user guides describe available integrations: .. toctree::