'rockcraft init --profile' links to non-existent versioned docs (1.20.0 URLs return 404)
Metadata
Current evaluation
Resolved by upgrading craft-application to >=7.2.0, which truncates docs URLs to the major version to prevent 404s. A regression test was added. The issue is closed as fixed.
Suggested action: —
No scores available.
Issue body
### Check existing issues
- [x] I've verified that this bug isn't described by any existing issues.
### Bug description
Whenever you run 'rockcraft init --profile' with any extension, either spring-boot-framework, flask-framework, django-framework, fastapi-framework. it redirects to version 1.20.0 of the stable docs.
<img width="1775" height="192" alt="Image" src="https://github.com/user-attachments/assets/a7c01b46-9aa4-4f76-9518-5f680f0b8a38" />
It seems those are not deployed yet (weird, as it seems that [version](https://github.com/canonical/rockcraft/releases/tag/1.20.0) was released last week).
You get the following:
<img width="1427" height="897" alt="Image" src="https://github.com/user-attachments/assets/8f293621-3707-410d-9612-0e3a46995007" />
The docs only work if I downgrade version to '1.19' meaning the url is now like this:
https://documentation.ubuntu.com/rockcraft/1.19/reference/extensions/spring-boot-framework/
it now loads the extension docs successfully.
Or if you simply click here
<img width="1602" height="1275" alt="Image" src="https://github.com/user-attachments/assets/8ae5ffcd-1a64-41a3-912b-92243a2c4d13" />
it will take you to the same url mentioned above.
# IMPORTANT
rockcraft.yaml is successfully generated, so this is only an issue docs-wise.
### Steps to reproduce
1. Run rockcraft init --profile spring-boot-framework in an empty directory
2. Open the URL printed in the output: https://documentation.ubuntu.com/rockcraft/1.20.0/reference/extensions/spring boot-framework
3. Observe a 404 error page
4. Change the version in the URL to 1.19: https://documentation.ubuntu.com/rockcraft/1.19/reference/extensions/spring-boot-framework/
5. The extension docs load successfully
6. Same behavior with other profiles: flask-framework, django-framework, fastapi-framework
### Environment
- Rockcraft version: 1.20.0 (installed via snap, latest/stable)
- OS: Ubuntu 26.04 LTS
- LXD and Multipass both available (not relevant, issue is in CLI output, not build)
### rockcraft.yaml
```yaml
```
### Log output
```shell
$ rockcraft init --profile spring-boot-framework
Go to https://documentation.ubuntu.com/rockcraft/1.20.0/reference/extensions/spring-boot-framework to read more about the 'spring-boot-framework' profile.
Successfully initialised project.
$ curl -sI https://documentation.ubuntu.com/rockcraft/1.20.0/reference/extensions/spring-boot-framework | head -1
HTTP/2 404
$ curl -sI https://documentation.ubuntu.com/rockcraft/1.19/reference/extensions/spring-boot-framework/ | head -1
HTTP/2 200
```
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Resolved by upgrading craft-application to >=7.2.0, which truncates docs URLs to the major version to prevent 404s. A regression test was added. The issue is closed as fixed. | |
| qwen3.6-35b-a3b-mtp-q6 |
Impact:
30
Quick Win:
24.0
Staleness:
50
Complexity:
20
Confidence:
60
Support Request:
10
|
needs triage | rockcraft init --profile generates 404 URLs with full version numbers; contributor proposed bumping craft-application to >=7.2.0 to fix. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
20
Confidence:
90
Support Request:
5
|
needs triage | rockcraft init --profile generates a 404 doc URL due to full version pinning. Contributor identified root cause in craft-application and proposed a fix. Awaiting maintainer triage. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
0
Complexity:
15
Confidence:
90
Support Request:
5
|
needs triage | rockcraft init --profile outputs a link to version 1.20.0 documentation that returns a 404. The generated config works, but the CLI link is broken. Awaiting maintainer triage. |
Update history
| Date | Change |
|---|---|
| closed | |
| updated | |
| created |
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1341 fix: use major-version docs URLs in init output | rockcraft | open | Bumps craft-application from 7.1.0 to 7.2.0 to fix 404 URLs in rockcraft init --profile output. Includes regression test and docs exclusion. Unreviewed, 15 days old. | |
| #1051 docs: TYPE YOUR QUESTION HERE | rockcraft | closed | Broken documentation link fixed. Contributor reported a 404 redirect for Rockcraft docs. Maintainer updated the URL to the correct stable path and closed the issue. |