← Back to issue list

docs: Fixes and 26.04 additions to documentation, and fix V2 gunicorn worker class 

View original Github issue

Metadata

Project
rockcraft
Number
#1391
Type
pull request
State
open
Author
javierdelapuente
Labels
documentation
Created
Updated
Closed
—

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.