Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: add-ons: add information about the index #19880

Merged
merged 1 commit into from
Jan 16, 2025

Conversation

greg-fer
Copy link
Contributor

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.

@greg-fer greg-fer added CI-disable Disable CI for this PR doc only labels Jan 13, 2025
@greg-fer greg-fer added this to the 3.0.0 milestone Jan 13, 2025
@greg-fer greg-fer requested a review from FilipZajdel January 13, 2025 15:49
@greg-fer greg-fer requested review from a team as code owners January 13, 2025 15:49
@github-actions github-actions bot added doc-required PR must not be merged without tech writer approval. changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. labels Jan 13, 2025
@greg-fer greg-fer force-pushed the doc_add_info_about_addon_index branch from f3f6a6a to 4a58430 Compare January 13, 2025 15:53
@greg-fer greg-fer requested a review from a team as a code owner January 13, 2025 15:53
@github-actions github-actions bot removed the changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. label Jan 13, 2025
@NordicBuilder
Copy link
Contributor

NordicBuilder commented Jan 13, 2025

CI Information

To view the history of this post, clich the 'edited' button above
Build number: 5

Inputs:

Sources:

more details

Github labels

Enabled Name Description
ci-disabled Disable the ci execution
ci-all-test Run all of ci, no test spec filtering will be done
ci-force-downstream Force execution of downstream even if twister fails
ci-run-twister Force run twister
ci-run-zephyr-twister Force run zephyr twister
List of changed files detected by CI (0)

Outputs:

Toolchain

Version:
Build docker image:

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

  • ◻️ Toolchain
  • ◻️ Build twister
  • ◻️ Integration tests

Note: This message is automatically posted and updated by the CI


.. tab:: nRF Connect for VS Code (recommended)

The add-on applications can be created using the following steps in the |nRFVSC|:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The add-on applications can be created using the following steps in the |nRFVSC|:
Complete the following steps in the |nRFVSC|:

.. 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
These instructions will guide you through the process of copying and configuring the add-on application in your workspace.
These instructions guide you through the process of copying and configuring the add-on application in your workspace.

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The add-on will be copied to your workspace and automatically configured with a west workspace, allowing you to start development right away.
The add-on is copied to your workspace and automatically configured with a west workspace, allowing you to start development right away.


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 <ncs-app-index_>`_.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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 <ncs-app-index_>`_.
For more information, including how to contribute your own add-on to the index, read the :file:`README.md` and :file:`CONTRIBUTING.md` documents in the `ncs-app-index repository <ncs-app-index_>`_.

The index can be accessed from the |nRFVSC|, and can also be browsed on `add-on webpage <nRF Connect SDK Add-ons_>`_.
Add-ons in the index follow specific contribution guidelines and are maintained by their respective owners.
The workspace applications listed there can be used to create out-of-tree :ref:`workspace applications <creating_add_on_index>`.
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 <ncs-app-index_>`_.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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 <ncs-app-index_>`_.
For more information, including how to contribute your own add-on to the index, read the :file:`README.md` and :file:`CONTRIBUTING.md` documents in the `ncs-app-index repository <ncs-app-index_>`_.

@@ -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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Some of these integrations are available through the `nRF Connect SDK Add-ons`_ page, which provides a curated collection of supplementary |NCS| components.
Some of these integrations are available through the `nRF Connect SDK Add-ons`_ page that provides a curated collection of supplementary |NCS| components.

@@ -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 <ncs-app-index_>`_.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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 <ncs-app-index_>`_.
For more information, including how to contribute your own add-on to the index, read the :file:`README.md` and :file:`CONTRIBUTING.md` documents in the `ncs-app-index repository <ncs-app-index_>`_.

@greg-fer greg-fer force-pushed the doc_add_info_about_addon_index branch 2 times, most recently from 4dae2f7 to 5f1ad3b Compare January 14, 2025 09:21
@greg-fer greg-fer requested a review from a team as a code owner January 14, 2025 09:21
@NordicBuilder
Copy link
Contributor

You can find the documentation preview for this PR at this link.

Note: This comment is automatically posted by the Documentation Publish GitHub Action.

@greg-fer greg-fer requested a review from peknis January 14, 2025 12:48
doc/nrf/glossary.rst Show resolved Hide resolved
doc/nrf/integrations.rst Outdated Show resolved Hide resolved
Copy link
Contributor

@FilipZajdel FilipZajdel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good.

@greg-fer greg-fer requested a review from wbober January 14, 2025 14:24
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 <[email protected]>
@greg-fer greg-fer force-pushed the doc_add_info_about_addon_index branch from 5f1ad3b to 4cb3d41 Compare January 14, 2025 14:28
@rlubos rlubos merged commit 458b9a1 into nrfconnect:main Jan 16, 2025
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CI-disable Disable CI for this PR doc only doc-required PR must not be merged without tech writer approval.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants