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

boards/nRF: Make documentation more consistent and updated #20592

Open
6 tasks
crasbe opened this issue Apr 17, 2024 · 1 comment
Open
6 tasks

boards/nRF: Make documentation more consistent and updated #20592

crasbe opened this issue Apr 17, 2024 · 1 comment

Comments

@crasbe
Copy link
Contributor

crasbe commented Apr 17, 2024

Description

The documentation for the Nordic Semiconductor nRF boards is in a somwhat inconsistent shape. This makes it harder to get started with these particular boards. Some features of the boards that RIOT supports are not mentioned in the documentation etc.
And it seems like they suffered a bit of bit rot and some information has to be updated.

  • Update OpenOCD flashing information in nRF Common documentation
  • Fix broken image in nRF52 documentation (maybe I can make one myself, so it does not rely on external images).
  • Add Hardware Overview (such as in nRF52DK) table to all nRF pages.
  • Add a section about the onboard flash memory to the nRF52840 page.
  • Add a picture to the nRF52840 Dongle page.
  • Add information about the limitations of NFC (as described in boards/doc: Explicitly warn when nRF chips are advertised as NFC supporting #20605 ).

Please do let me know if you see more potential tasks to do.
I'll get started on this next week(-ish).

Useful links

https://doc.riot-os.org/group__boards__common__nrf52.html
https://doc.riot-os.org/group__boards__nrf52dk.html
https://doc.riot-os.org/group__boards__nrf52840dk.html
https://doc.riot-os.org/group__boards__nrf52840dongle.html
https://doc.riot-os.org/group__boards__nrf52832-mdk.html
https://doc.riot-os.org/group__boards__nrf51dk.html
https://doc.riot-os.org/group__boards__nrf51dongle.html

@crasbe
Copy link
Contributor Author

crasbe commented Apr 22, 2024

@mguetschow the last ToDo item was meant for the boards that currently have no information about NFC at all (like the nRF52DK, nRF52840DK, ..?)
So it is not quite done yet, but I added a reference to your PR so I could keep it in mind to add it :D

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant