Skip to content

Commit 0c276f3

Browse files
committed
Documentation Initial Review
Initial review changes for docs. Adding workflows files to publish site.
1 parent 7a2e301 commit 0c276f3

File tree

6 files changed

+69
-21
lines changed

6 files changed

+69
-21
lines changed
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
name: Build Documentation
2+
3+
# Allows you to run this workflow manually from the Actions tab
4+
# on:
5+
# workflow_dispatch:
6+
# branches: ["main"]
7+
8+
# Allows this workflow to run automatically on pushes/commits
9+
on:
10+
push:
11+
branches: ["main"]
12+
13+
# Sets permissions of the GITHUB_TOKEN to allow files to be committed to gh-pages branch
14+
permissions:
15+
contents: write
16+
17+
18+
jobs:
19+
deploy:
20+
runs-on: ubuntu-latest
21+
22+
steps:
23+
- name: Checkout repository
24+
uses: actions/checkout@v4
25+
with:
26+
fetch-depth: 0
27+
28+
- name: Install pgnquant for optimize plugin
29+
run: sudo apt-get install pngquant
30+
31+
- name: Set up Python runtime
32+
uses: actions/setup-python@v5
33+
with:
34+
python-version: 3.x
35+
36+
- name: Install Python dependencies
37+
run: pip install mkdocs-monorepo-plugin mkdocs-redirects mkdocs-git-authors-plugin mkdocs-git-revision-date-localized-plugin mkdocs-git-committers-plugin-2 Pillow 'mkdocs-material[imaging]'
38+
39+
- name: Set up build cache
40+
run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
41+
- uses: actions/cache@v4
42+
with:
43+
key: mkdocs-material-${{ env.cache_id }}
44+
path: .cache
45+
restore-keys: |
46+
mkdocs-material-
47+
48+
- name: Install Insiders build
49+
env:
50+
MKDOCS_TOKEN: ${{ secrets.MKDOCS_SECRET }}
51+
run: pip install git+https://${MKDOCS_TOKEN}@github.com/squidfunk/mkdocs-material-insiders.git
52+
- run: mkdocs gh-deploy --force

docs/assets/img/arduino_boards.jpg

94.2 KB
Loading

docs/github/contribute.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Contribute: Make an Augmentation!
2-
Spot an improvement opportunity? Feel free to contribute to our open-source design and documentation. <a href="https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/pulls" alt="Pull Requests"><img src="https://img.shields.io/github/issues-pr/sparkfun/SparkFun_Pro_Micro_RP2350.svg" /></a>
2+
Spot an improvement opportunity? Feel free to contribute to our open-source design and documentation. <a href="https://github.com/sparkfun/SparkFun_Iot_RedBoard_RP2350/pulls" alt="Pull Requests"><img src="https://img.shields.io/github/issues-pr/sparkfun/SparkFun_IoT_RedBoard_RP2350.svg" /></a>
33

44
## :material-file-document-multiple:&nbsp;Improve our Documentation
55
All of this documentation can be modified by you! Please help us make it better.
66

7-
* These pages are contained in the [`docs` folder](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/tree/main/docs) of the [<Official Product Name> repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350).
7+
* These pages are contained in the [`docs` folder](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/tree/main/docs) of the [SparkFun IoT RedBoard repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350).
88

99
<!-- ### :material-source-pull:&nbsp;Submit a Correction -->
1010
### Submit a Correction
1111

12-
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/fork).
12+
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/fork).
1313
2. Add your corrections or improvements to the markdown file.
1414
3. File a pull request with your changes, and enjoy making the ~~words~~ ~~worlds~~ world a better place.
1515
* Once received, the documentation specialist will automatically be notified.
@@ -18,12 +18,12 @@ All of this documentation can be modified by you! Please help us make it better.
1818
## :material-cog:&nbsp;Improve our Hardware Design
1919
All of our designs are open-source! Please help us make it better.
2020

21-
* Our board design files are contained in the [`Hardware` folder](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/tree/main/Hardware) of the [<Official Product Name> repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350).
21+
* Our board design files are contained in the [`Hardware` folder](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/tree/main/Hardware) of the [<Official Product Name> repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350).
2222

2323
<!-- ### :material-source-pull:&nbsp;Submit a Design Enhancement -->
2424
### Submit a Design Enhancement
2525

26-
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/fork).
26+
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/fork).
2727
2. Add your design augmentation(s)
2828
3. File a pull request with your changes, and enjoy making the ~~words~~ ~~worlds~~ world a better place.
2929
1. Once received, the engineer in charge of the original design will automatically be notified.
@@ -36,6 +36,6 @@ All of our designs are open-source! Please help us make it better.
3636
## Contributors&nbsp;:clap:
3737
Let's provide some recognition to the contributors for this project!
3838

39-
![GitHub Contributors Image](https://contrib.rocks/image?repo=sparkfun/SparkFun_Pro_Micro_RP2350)
39+
![GitHub Contributors Image](https://contrib.rocks/image?repo=sparkfun/SparkFun_IoT_RedBoard_RP2350)
4040
<br>
41-
<a href="https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/pulls" alt="Pull Requests"><img src="https://img.shields.io/github/contributors/sparkfun/SparkFun_Pro_Micro_RP2350.svg" /></a>
41+
<a href="https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/pulls" alt="Pull Requests"><img src="https://img.shields.io/github/contributors/sparkfun/SparkFun_IoT_RedBoard_RP2350.svg" /></a>

docs/github/file_issue.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Did we make a mistake?
22

3-
Spot something wrong? Please let us know. <a href="https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/issues" alt="Issues"><img src="https://img.shields.io/github/issues/sparkfun/SparkFun_Pro_Micro_RP2350.svg" /></a>
3+
Spot something wrong? Please let us know. <a href="https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/issues" alt="Issues"><img src="https://img.shields.io/github/issues/sparkfun/SparkFun_IoT_RedBoard_RP2350.svg" /></a>
44

55
<!-- Technical Assistance Box -->
66
!!! warning "Need Help?"
@@ -20,15 +20,15 @@ Spot something wrong? Please let us know. <a href="https://github.com/sparkfun/S
2020

2121
All of our documentation can be modified by you! Please help us make it better.
2222

23-
* The documentation files for these pages are contained in the [`docs` folder](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/tree/main/docs) of the [<Official Product Name> repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350).
23+
* The documentation files for these pages are contained in the [`docs` folder](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/tree/main/docs) of the [<Official Product Name> repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350).
2424

2525
### 🔍 Spot something wrong?
2626

27-
If a section of the documentation is incorrect, please [open an issue](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/issues) and let us know.
27+
If a section of the documentation is incorrect, please [open an issue](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/issues) and let us know.
2828

2929
### Do you have a suggested correction?
3030

31-
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/fork).
31+
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/fork).
3232
2. Add your correction(s) or improvement(s) to the markdown file(s)
3333
3. File a pull request with your changes, and enjoy making the ~~words~~ ~~worlds~~ world a better place.
3434
* Once received, the documentation specialist will automatically be notified.
@@ -38,15 +38,15 @@ If a section of the documentation is incorrect, please [open an issue](https://g
3838

3939
All of our designs are open-source! Please help us make it better.
4040

41-
* Our board design files are contained in the [`Hardware` folder](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/tree/main/Hardware) of the [<Official Product Name> repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350).
41+
* Our board design files are contained in the [`Hardware` folder](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/tree/main/Hardware) of the [<Official Product Name> repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350).
4242

4343
### Does something not make sense? 🤔
4444

45-
If part of the design is confusing, please [open an issue](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/issues) and let us know.
45+
If part of the design is confusing, please [open an issue](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/issues) and let us know.
4646

4747
### Did we forget to include an important function of the board? 🤦
4848

49-
If part of the board's functionality is missing, please [open an issue](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/issues) and file a feature request.
49+
If part of the board's functionality is missing, please [open an issue](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/issues) and file a feature request.
5050

5151
!!! tip "Design Considerations"
5252
Please keep in mind that we may intentionally exclude certain functions of the board to meet our product design requirements.
@@ -56,7 +56,7 @@ If part of the board's functionality is missing, please [open an issue](https://
5656

5757
### Do you wish to contribute directly to improving the board design?
5858

59-
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_Pro_Micro_RP2350/fork).
59+
1. With a GitHub account, [fork this repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard_RP2350/fork).
6060
2. Add your design augmentation(s)
6161
3. File a pull request with your changes, and enjoy making the ~~words~~ ~~worlds~~ world a better place.
6262
1. Once received, the engineer in charge of the original design will automatically be notified.

docs/micropython.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,6 @@ MicroPython is an application of the Python 3 language that runs on microcontrol
88

99
## UF2 Firmware
1010

11-
The SparkFun IoT RedBoard - RP2350 is available in the main release of MicroPython [here](https://micropython.org/download/). Search for "SparkFun IoT RedBoard - RP2350" on the MicroPython downloads page for the correct firmware. This release does **not** include PSRAM support. of MicroPython to include UF2 files for the IoT RedBoard - RP2350 so to get users started before then, we have Beta releases of MicroPython firmware available [here](https://github.com/sparkfun/micropython/releases) or by clicking the button below:
12-
13-
<center>
14-
[SparkFun MicroPython Beta Releases](https://github.com/sparkfun/micropython/releases){ .md-button .md-button--primary}
15-
</center>
11+
The SparkFun IoT RedBoard - RP2350 ships with MicroPython firmware pre-loaded so you do not need to download and install it in your board. If you need to update the firmware at any point, it is available in the main release of MicroPython [here](https://micropython.org/download/). Search for "SparkFun IoT RedBoard - RP2350" on the MicroPython downloads page for the correct firmware. This release does **not** include PSRAM support; if your project requires using PSRAM, you can find a Beta release MicroPython firmware available [here](https://github.com/sparkfun/micropython/releases).
1612

1713
Download the latest release and then put the IoT RedBoard - RP2350 into UF2 bootloader mode and open the location the board appeared as a USB storage device (it should appear as "RP2350"). Next, drag and drop the UF2 file into the RP2350 folder and the board should reboot. After the board reboots, open up your preferred MicroPython IDE (or command line interface) and you can start interacting with your RedBoard IoT. Head over to the Quick Start guide for an example project that shows how to connect the board to a WiFi network, download data from a website and control the RGB LED.

mkdocs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ plugins:
154154
type: timeago
155155
# Add git committers at the bottom of the page
156156
- git-committers:
157-
repository: sparkfun/SparkFun_Pro_Micro_RP2350
157+
repository: sparkfun/SparkFun_IoT_RedBoard_RP2350
158158
branch: main
159159
# Add git authors at the bottom of the page
160160
- git-authors

0 commit comments

Comments
 (0)