[docs] GSoC 26 improvements, roadmap FW upgrader UX updates

[nemesifier]

Added links to:

openwisp/openwisp-firmware-upgrader#377
openwisp/openwisp-firmware-upgrader#378
openwisp/openwisp-firmware-upgrader#379
openwisp/openwisp-firmware-upgrader#380

[coderabbitai]

Warning

Rate limit exceeded

@nemesifier has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 4 minutes and 17 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 26d9b14 and 74a8c13.

📒 Files selected for processing (2)

• .github/workflows/ci.yml
• requirements.txt

Walkthrough

This pull request updates two documentation files. The developer/gsoc-ideas-2026.rst file refines the OpenWISP Firmware Upgrader proposal: rephrases automatic extraction of firmware metadata to emphasize extraction at upload time, standardizes memory-related wording, adds an "Other constraints" subsection (testing, docs, short usage video), and introduces an extensibility narrative for Upgrader and metadata extraction classes. The general/roadmap-2030.rst file removes a past GSOC note and adds status blocks for Persistent Mass Upgrades and Scheduled Mass Upgrades, plus an expanded Automated Firmware Image Identification plan.

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• [gsoc26] Automatic Extraction of OpenWrt Firmware Image Metadata #264: Edits documentation around automatic extraction of OpenWrt firmware image metadata and overlaps with the same docs and feature descriptions updated here.

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically summarizes the main changes: GSoC 26 improvements and firmware upgrader UX roadmap updates to two documentation files.
Description check	✅ Passed	The description is relevant to the changeset, providing specific links to firmware upgrader repository items that relate to the documentation updates being made.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch gsoc26-improvements

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

developer/gsoc-ideas-2026.rst (1)

1-1010: ⚠️ Potential issue | 🔴 Critical

ReStructuredText formatting check failed - blocking issue.

The pipeline indicates this file requires reformatting to pass the RST quality checks. Please run the formatting tool locally to fix the issue.

Run the following command to identify and fix the formatting issues:

#!/bin/bash
# Check RST formatting issues
cd developer
# Attempt to identify the specific formatting problems
python -m rstcheck gsoc-ideas-2026.rst --report-level warning

📜 Review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 934f0e4 and cd95aeb.

📒 Files selected for processing (2)

• developer/gsoc-ideas-2026.rst
• general/roadmap-2030.rst

🧰 Additional context used

🪛 GitHub Actions: OpenWISP Docs

developer/gsoc-ideas-2026.rst

[error] 1-1: Step PRODUCTION=1 ./run-qa-checks: ReStructuredText check failed. File could be reformatted. 1 out of 44 files could be reformatted.

🔇 Additional comments (7)

developer/gsoc-ideas-2026.rst (3)

156-164: LGTM! Clear constraints added.

The new "Other constraints" section effectively communicates testing, documentation, and deliverable requirements upfront, which helps set clear expectations for contributors.

---

225-236: LGTM! Important architectural context.

This section clearly explains the extensibility requirements using the Upgrader Class pattern, which will help contributors understand the architectural constraints when implementing metadata extraction.

---

363-363: Change section header underlines to plus signs for consistency.

Lines 363 and 456 use dotted underlines (.), but 30 other subsection-level headers throughout the document use plus signs (+). Replace the dotted underlines with plus signs to match the established formatting standard and resolve the pipeline formatting failure.

-..............................................
++++++++++++++++++++++++++++++++++++++++++++++

-................
+................

general/roadmap-2030.rst (4)

269-270: LGTM! Status transparency is helpful.

The added status update with a link to the work-in-progress PR provides useful context for the community about ongoing firmware upgrader improvements.

---

276-277: LGTM! Consistent status tracking.

The status update maintains consistency with the previous entry and correctly indicates both features are being developed in the same PR.

---

279-291: LGTM! Well-documented new features.

Both "Persistent Mass Upgrades" and "Scheduled Mass Upgrades" are clearly described with appropriate detail levels for a roadmap document. The links to detailed GitHub issues provide comprehensive context for interested contributors.

---

313-315: LGTM! Helpful detailed plan reference.

The added detailed plan link completes the documentation pattern and aligns well with the corresponding GSoC 2026 project idea documentation.

_{✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.}