docs: Fixes and 26.04 additions to documentation, and fix V2 gunicorn worker class
Metadata
Current evaluation
Documentation updates for 12-factor extensions on Ubuntu 26.04 and a gunicorn worker class fix. Approved by 4 reviewers with 0 unresolved comments, but CI failing on lint and OSV-scanner.
Suggested action: needs review
Reason: PR has 4 approvals and 0 unresolved review comments, but CI is failing on 'lint / files' and 'Security scan / OSV-scanner'. @erinecon noted the linter failure is due to link timeouts blocking the merge. Once CI passes, the PR is ready to land.
Evaluated by: mr-cal-bot
Impact:
35
Quick Win:
16
Complexity:
25
Confidence:
75
Actionability:
60
Issue body
**Docs**
Updates the 12-factor extension docs for Ubuntu 26.04 and fixes errors found by checking each claim against the extension code and real packs.
* How-to guides:
- set-up-web-app-rock now covers --base ubuntu@26.04, the Spring Boot init, extra files, extra debs, and the experimental extensions.
- use-web-app-rock now has Express and Spring Boot tabs.
- The Express build-base guide quotes npm-node-version values ( "20.12" ).
- The migration guide fixes rockcraft list-extensions and the uv/Poetry paragraph.
* Reference pages (Flask, Django, FastAPI, Go, Express, Spring Boot):
- Flask and FastAPI only include their default files, so other modules must be listed in prime.
- The rock name must equal the last element of the Go module path.
- On bare rocks, extra packages must be slices, because mixing packages and slices fails.
- The Express docs now say that files and .npmignore apply, and that a build script's dist is always included.
- The <name> directory has - replaced by _ .
**Small Code fix**
On Ubuntu 26.04, the Flask and Django extensions started gunicorn with -k sync . The V1 extensions (22.04 and 24.04) use -k [ sync ] , and paas-charm rewrites that value itself. This PR removes the _worker_class_template = "{}" override in gunicorn.py , so V2 uses the same form as V1. I updated the two unit tests that expected the old form.
---
- [x] I've followed the [contribution guidelines](https://github.com/canonical/rockcraft/blob/main/CONTRIBUTING.md).
- [x] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
- [x] I've successfully run `make lint && make test`.
- [x] I've added or updated any relevant documentation.
- [ ] In documents I changed, I [added a meta description](https://canonical-starflow.readthedocs-hosted.com/how-to/add-a-page-meta-description/) if one was missing.
- [ ] I've updated the relevant release notes.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b |
Impact:
35
Quick Win:
16
Complexity:
25
Confidence:
75
Actionability:
60
|
needs review | Documentation updates for 12-factor extensions on Ubuntu 26.04 and a gunicorn worker class fix. Approved by 4 reviewers with 0 unresolved comments, but CI failing on lint and OSV-scanner. | |
| qwen/qwen3.6-35b-a3b |
Impact:
45
Quick Win:
16
Complexity:
30
Confidence:
75
Actionability:
50
|
needs review | Documentation updates for 12-factor extensions on Ubuntu 26.04 and gunicorn worker class fix. Approved by 4 reviewers but has 10 unresolved comments and 2 failing CI checks. | |
| qwen/qwen3.6-35b-a3b |
Impact:
50
Quick Win:
21
Complexity:
30
Confidence:
75
Actionability:
60
|
needs review | Documentation updates for 12-factor extensions on Ubuntu 26.04 and removal of _worker_class_template override in gunicorn.py for V2 consistency. Approved by 3 reviewers but CI failing on source-spread-tests and lint/files. | |
| qwen/qwen3.6-35b-a3b |
Impact:
55
Quick Win:
33
Complexity:
30
Confidence:
85
Actionability:
85
|
needs review | Documentation updates for 12-factor extensions on Ubuntu 26.04 and a fix to remove _worker_class_template override in gunicorn.py for V2 consistency with V1. Approved by 3 reviewers, CI passing. | |
| qwen/qwen3.6-35b-a3b |
Impact:
45
Quick Win:
18
Complexity:
35
Confidence:
75
Actionability:
60
|
needs review | Documentation updates for 12-factor extensions on Ubuntu 26.04 and a fix to remove gunicorn worker class override for V2 consistency. Approved by 3 reviewers with 0 unresolved comments; 2 CI checks failing (source-spread-tests, lint / files). |
Update history
| Date | Change |
|---|---|
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| created |
Related issues
No related issues found above the similarity threshold.